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
| Prop | Type | Default | Description |
|---|---|---|---|
| modelValue | any | — | Selected value. Supports v-model. |
| open | boolean | — | Dropdown open state. Supports v-model:open. |
| multiple | boolean | false | Allow selecting several items. |
| filterFunction | (items, search) => items | — | Override default fuzzy filter. |
Events
| Event | Description |
|---|---|
| update:modelValue | Fires when the selection changes. Enables v-model. |
| update:open | Fires when the dropdown opens or closes. |
Slots
| Slot | Description |
|---|---|
| default | Anchor, list, and item sub-components. |
ComboboxAnchor / ComboboxInput
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| class | string | — | Anchor wraps the trigger; Input is the search field. Forwards to reka-ui. |
Events
| Event | Description |
|---|---|
| update:modelValue | (ComboboxInput) Fires as the search text changes. |
ComboboxList
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| class | string | — | Floating results panel. Forwards positioning props to reka-ui ComboboxContent. |
ComboboxItem
Props
| Prop | Type | Default | Description |
|---|---|---|---|
| value | any | — | Value committed when the item is selected. |
| disabled | boolean | false | Disable selection of this item. |
Events
| Event | Description |
|---|---|
| select | Fires when the item is chosen. |
Accessibility
Keyboard shortcuts and ARIA behavior.
Keyboard
| Shortcut | Description |
|---|---|
| A | Typing in the input filters the options. |
| ↑ | Moves the highlight to the previous option. |
| ↓ | Moves the highlight to the next option. |
| Home | Jumps to the first option. |
| End | Jumps to the last option. |
| Enter | Selects the highlighted option. |
| Esc | Closes 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.