Design system

Combobox

Search and choose one value from a list.

Use a combobox when a list is long enough that filtering helps users find the right value.

Built on Base UIUpstream API

Import

import {
  Combobox,
  ComboboxContent,
  ComboboxInput,
  ComboboxItem,
  ComboboxList,
} from "@workshop1/ui/components/combobox"

Composition

Compose ComboboxInput, ComboboxContent, ComboboxList, and ComboboxItem. Add ComboboxEmpty for a useful empty state and ComboboxGroup when results need categories.

Accessibility

Give the input a clear placeholder or visible label. Keep item text specific enough for keyboard type-ahead and announce an empty result state when filtering returns no matches.

Best practices

  • Use a select for short, stable lists.
  • Keep filtering fast and predictable.
  • Add clear and multi-value chip controls only when the workflow needs them.