Combobox

Searchable select with keyboard navigation. Supports flat and grouped options. Use when the option list is long enough that filtering adds value.

Examples

items*

ComboboxOption[] | ComboboxGroup[]

Flat list of options or grouped options.

value

string

Controlled selected value.

defaultValue

string

Initial value for uncontrolled usage.

onValueChange

(value: string) => void

Called when the selection changes.

placeholder= 'Select…'

string

Trigger label when nothing is selected.

searchPlaceholder= 'Search…'

string

Placeholder inside the search input.

emptyText= 'No results found.'

string

Message when search returns no matches.

size= 'md'

'sm' | 'md' | 'lg'

Height and padding scale.

error= false

boolean

Applies error border colour.

disabled= false

boolean

Disables the combobox.

Prop	Type	Default	Description
items*	ComboboxOption[] \| ComboboxGroup[]	—	Flat list of options or grouped options.
value	string	—	Controlled selected value.
defaultValue	string	—	Initial value for uncontrolled usage.
onValueChange	(value: string) => void	—	Called when the selection changes.
placeholder	string	'Select…'	Trigger label when nothing is selected.
searchPlaceholder	string	'Search…'	Placeholder inside the search input.
emptyText	string	'No results found.'	Message when search returns no matches.
size	'sm' \| 'md' \| 'lg'	'md'	Height and padding scale.
error	boolean	false	Applies error border colour.
disabled	boolean	false	Disables the combobox.