Combobox API

Constrains accepted values to registered options. - false (default): confirming (Enter/Tab) typed text with no match commits it as a new value - true: unmatched text is discarded on confirm; only registered options can be selected

Default: false

error

boolean | undefined

Manual error state override — forces invalid regardless of error messages

Default: false

errorMessages

any

Manual error messages

adapter

any

Filtering/loading adapter (client-side or server-side)

positionAdapter

any

Positioning engine for the dropdown.

displayValue

((value: unknown) => string) | undefined

Maps selected value to input display text. Defaults to String(value).

modelValue

T | T[] | undefined

Events

update:model-value

[value: T | T[]]

Slots

default

ComboboxRootSlotProps

Combobox.Activator

Props

namespace

string | undefined

Namespace for dependency injection

Default: "v0:combobox"

Slots

default

ComboboxActivatorSlotProps

Combobox.Content

Props

namespace

string | undefined

Namespace for dependency injection

Default: "v0:combobox"

eager

boolean | undefined

Render content immediately without waiting for first open

Default: false

Slots

default

ComboboxContentSlotProps

Combobox.Control

Props

namespace

string | undefined

Namespace for dependency injection

Default: "v0:combobox"

openOn

"focus" | "input" | undefined

When to open the dropdown

Default: "focus"

placeholder

string | undefined

Placeholder text

Slots

default

ComboboxControlSlotProps

Combobox.Cue

Props

namespace

string | undefined

Default: "v0:combobox"

Slots

default

ComboboxCueSlotProps

Combobox.Description

Props

namespace

string | undefined

Namespace for connecting to parent Combobox.Root

Default: "v0:combobox"

Slots

default

ComboboxDescriptionSlotProps

Combobox.Empty

Props

namespace

string | undefined

Namespace for dependency injection

Default: "v0:combobox"

Slots

default

ComboboxEmptySlotProps

Combobox.Error

Props

namespace

string | undefined

Namespace for connecting to parent Combobox.Root

Default: "v0:combobox"

Slots

default

ComboboxErrorSlotProps

Combobox.HiddenInput

Props

namespace

string | undefined

Default: "v0:combobox"

Combobox.Item

Props

namespace

string | undefined

Namespace for dependency injection

Default: "v0:combobox"

id

string | undefined

Unique identifier (auto-generated if not provided)

value

V | undefined

Value associated with this option

disabled

MaybeRefOrGetter<boolean> | undefined

Disables this specific option

el

any

Host element when renderless. Virtual focus uses this instead of the Atom node.

Slots

default

ComboboxItemSlotProps<V>