Select API

API reference for the Select components.

Selection.Root

Props

namespace

string

Namespace for dependency injection (must match SelectionItem namespace)

Default: "v0:selection"

disabled

boolean

Disables the entire selection instance

Default: false

enroll

boolean

Auto-select non-disabled items on registration

Default: false

Controls mandatory selection behavior: - false (default): No mandatory selection enforcement - true: Prevents deselecting the last selected item - `force`: Automatically selects the first non-disabled item on registration

Default: false

multiple

boolean

Enable multi-selection mode (array v-model)

Default: false

modelValue

T | T[]

Events

update:model-value

[value: T | T[]]

Slots

default

SelectionRootSlotProps

Select.Root

Props

name

string

Form field name — auto-renders hidden input when provided

namespace

string

Namespace for dependency injection

Default: "v0:select"

id

string

Unique identifier (auto-generated if not provided)

form

string

Associate with a form by ID

disabled

boolean

Disables the entire select

Default: false

multiple

boolean

Enable multi-selection mode

Default: false

mandatory

boolean | "force"

Default: false

modelValue

any

Events

update:model-value

[value: any]

Slots

default

SelectRootSlotProps

Select.Activator

Props

namespace

string

Namespace for dependency injection

Default: "v0:select"

Slots

default

SelectActivatorSlotProps

Select.Content

Props

namespace

string

Namespace for dependency injection

Default: "v0:select"

Slots

default

SelectContentSlotProps

Select.Cue

Props

namespace

string

Default: "v0:select"

Slots

default

SelectCueSlotProps

Select.HiddenInput

Props

namespace

string

Default: "v0:select"

Select.Item

Props

namespace

string

Namespace for dependency injection

Default: "v0:select"

id

string

Unique identifier (auto-generated if not provided)

value

V

Value associated with this option

disabled

MaybeRefOrGetter<boolean>

Disables this specific option

Slots

default

SelectItemSlotProps<V>

Select.Placeholder

Props

namespace

string

Default: "v0:select"

Slots

default

SelectPlaceholderSlotProps

Select.Value

Props

namespace

string

Namespace for dependency injection

Default: "v0:select"

Slots

default

SelectValueSlotProps

Selection.Item

Props

id

string

Unique identifier (auto-generated if not provided)

label

string

Optional display label (passed through to slot, not used in registration)

value

V

Value associated with this item

disabled

MaybeRefOrGetter<boolean>

Disables this specific item

namespace

string

Namespace for dependency injection

Default: "v0:selection"

Slots

default

SelectionItemSlotProps<V>