On this page
Combobox
Provides a searchable control for single or multiple selection.
Overview
Copy the source into your project. Import the parts that you need. Styles use local StyleX declarations and shared theme tokens. You can change the source without a wrapper or replacement package.
Preview
Searchable options
Installation
Run the init command from your project root first. The CLI configures StyleX and installs shared files and dependencies.
Run from your project root. The CLI installs required components, shared files, and packages. Previews may need additional components. The CLI keeps existing files.
Usage
Compose ComboboxInput and ComboboxPopup with ComboboxList and ComboboxItem inside Combobox.
For multiple selection, use ComboboxChips, ComboboxChip, and ComboboxChipsInput. Each chip includes a remove control. Supply items. If options are objects, supply a stable mapping from each item to its value.
Option hover uses the neutral accent pair. Selected options use the solid accent pair, including when highlighted.
ComboboxEmpty handles no matches. ComboboxCollection supports grouped rendering. useComboboxFilter matches strings for the selected locale.
Import from the local file installed by the CLI.
API reference
The generator reads the component TypeScript source. Only component and Base UI props appear below. The Required column shows whether you must supply a property. It does not mean you must use the component.