Combo Box

Drop down a list, type to narrow it down, like flipping through a phone book with a quick finder tool.

Basic

A combo box combines a text input with a listbox, allowing users to filter options to match what they're looking for.

Installation

Using Avatars

The combo box can be configured to display avatars instead of just regular text.

Section

A combo box can display items grouped together in sections.

Validation

If a user submits the form without selecting an item, an error message will appear.

Controlled

There are two ways to control the combo box: using the onInputChange prop or the onSelectionChange prop. These methods serve different purposes, as illustrated in the examples below. Both examples follow the same approach, defining id and textValue for the options.

When you only need the textValue of the selected option, use the onInputChange prop. However, if you need to obtain the actual id of the selected option, the onSelectionChange prop is the appropriate choice.

Input

This combo box is controlled by the onInputChange prop.

Selection

This combo box is controlled by the onSelectionChange prop.

Readonly

When the combo box is in a readonly state, it cannot be edited.

Disabled

When the combo box is disabled, it becomes non-interactive and cannot be edited.