Input API

Headless text input with integrated validation and automatic form registration.

Explore these related pages for additional context and usage patterns.

Page	Category
Input	Forms
createInput	Forms
createNumeric	Forms
createValidation	Forms
createForm	Forms
Checkbox	Forms
Switch	Forms

Input.Root

Props

id

any

Unique identifier (auto-generated if not provided)

Default: useId()

label

string | undefined

Optional display label

name

string | undefined

Form field name

type

string | undefined

Input type

Default: "text"

form

string | undefined

Associate with form by ID

disabled

MaybeRefOrGetter<boolean> | undefined

Disables this input

Default: false

readonly

MaybeRefOrGetter<boolean> | undefined

Makes this input readonly

required

boolean | undefined

Whether this input is required

rules

any[] | undefined

Validation rules

Default: []

validateOn

ValidateOn | undefined

When to trigger validation

Default: "blur"

error

boolean | undefined

Manual error state override — forces invalid regardless of validation

Default: false

errorMessages

any

Manual error messages — merged with rule-based errors

namespace

string | undefined

Namespace for context provision to children

Default: "v0:input:root"

modelValue

string | undefined

Default: ""

focused

boolean | undefined

Default: false

Events

update:focused

unknown[]

update:model-value

[value: string]

Slots

default

InputRootSlotProps

Input.Control

Props

namespace

string | undefined

Default: "v0:input:root"

Slots

default

InputControlSlotProps

Input.Description

Props

id

string | undefined

Unique identifier (auto-generated if not provided)

Default: useId()

namespace

string | undefined

Namespace for connecting to parent Input.Root

Default: "v0:input:root"

Slots

default

InputDescriptionSlotProps

Input.Error

Props

id

string | undefined

Unique identifier (auto-generated if not provided)

Default: useId()

namespace

string | undefined

Namespace for connecting to parent Input.Root

Default: "v0:input:root"

Slots

default

InputErrorSlotProps