ComboBox

A combo box combines a text input with a listbox, allowing users to filter a list of options to items matching a query.

Empty state

When filtering returns no matches, the combo box displays a helpful empty state. Use renderEmptyState to replace it with custom content.

Name	Type	Description
inputValue	string	Controlled input value
defaultInputValue	string	Default input value
selectedKey	string	Controlled selected key
defaultSelectedKey	string	Default selected key
isDisabled	boolean	Disables the combobox
onInputChange	(value: string) => void	Called when input changes
onSelectionChange	(key: string) => void	Called when selection changes
renderEmptyState	Function	Replaces the default empty-state message

Name

Type

Description

inputValue

string

Controlled input value

defaultInputValue

string

Default input value

selectedKey

string

Controlled selected key

defaultSelectedKey

string

Default selected key

isDisabled

boolean

Disables the combobox

onInputChange

(value: string) => void

Called when input changes

onSelectionChange

(key: string) => void

Called when selection changes

renderEmptyState

Function

Replaces the default empty-state message