Toggle Sidebar B
header.lightDarkMode D

Select

Single-value dropdown built on reka-ui. For pickers that need search across many options, use Combobox instead.

Default

Trigger, value placeholder, then SelectItem rows inside Content.

With groups

Group options with SelectGroup and SelectLabel. Labels are visual separators, not selectable.

Disabled

The disabled attribute on the Select root disables the trigger.

API Reference

Props, events, and slots for each sub-component.

Select

Props

PropTypeDefaultDescription
modelValuestringSelected value. Supports v-model.
defaultValuestringStarting value when v-model is not used.
disabledbooleanfalseDisable the entire select.

Events

EventDescription
update:modelValueFires when the value changes. Enables v-model.
update:openFires when the dropdown opens or closes.

SelectTrigger / SelectContent

Props

PropTypeDefaultDescription
classstringUse class to set trigger width (e.g. w-[220px]).

SelectItem

Props

PropTypeDefaultDescription
valuestringValue committed when selected.
disabledbooleanfalseBlock selection of this item.

Events

EventDescription
selectFires when the item is chosen.

SelectGroup / SelectLabel / SelectValue / SelectSeparator

Props

PropTypeDefaultDescription
placeholderstring(SelectValue) Text shown when nothing is selected. Group/Label organise items; Separator divides them.

Accessibility

Keyboard shortcuts and ARIA behavior.

Keyboard

ShortcutDescription
SpaceOpens the listbox when the trigger is focused.
EnterOpens the listbox, or selects the highlighted option.
Moves the highlight to the previous option.
Moves the highlight to the next option.
HomeMoves the highlight to the first option.
EndMoves the highlight to the last option.
EscCloses the listbox and returns focus to the trigger.
  • Follows the listbox pattern; the trigger exposes aria-expanded and the active option via aria-activedescendant.
  • Type-ahead jumps to options whose label starts with the typed characters.
  • Selected option is marked with aria-selected.