Toggle Sidebar B
header.lightDarkMode D

Combobox

Searchable dropdown that filters items as you type. Built on reka-ui. Use for pickers with many options where a flat Select feels cumbersome.

Default

Type to filter a static option list.

Multiple

Set multiple to select several items at once.

Disabled

Pass disabled to block all interaction.

API Reference

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

Combobox

Props

PropTypeDefaultDescription
modelValueanySelected value. Supports v-model.
openbooleanDropdown open state. Supports v-model:open.
multiplebooleanfalseAllow selecting several items.
filterFunction(items, search) => itemsOverride default fuzzy filter.

Events

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

Slots

SlotDescription
defaultAnchor, list, and item sub-components.

ComboboxAnchor / ComboboxInput

Props

PropTypeDefaultDescription
classstringAnchor wraps the trigger; Input is the search field. Forwards to reka-ui.

Events

EventDescription
update:modelValue(ComboboxInput) Fires as the search text changes.

ComboboxList

Props

PropTypeDefaultDescription
classstringFloating results panel. Forwards positioning props to reka-ui ComboboxContent.

ComboboxItem

Props

PropTypeDefaultDescription
valueanyValue committed when the item is selected.
disabledbooleanfalseDisable selection of this item.

Events

EventDescription
selectFires when the item is chosen.

Accessibility

Keyboard shortcuts and ARIA behavior.

Keyboard

ShortcutDescription
ATyping in the input filters the options.
Moves the highlight to the previous option.
Moves the highlight to the next option.
HomeJumps to the first option.
EndJumps to the last option.
EnterSelects the highlighted option.
EscCloses the dropdown.
  • Built on reka-ui Combobox, pairing a textbox input with a role=listbox of options.
  • The input exposes aria-expanded and aria-activedescendant tracks the highlighted option.