Skip to main content
Select is Clementine DS’s single-choice dropdown picker. It wraps Mantine’s Select component — which is itself built on top of Mantine’s Combobox primitive — and re-exports it with Clementine token bindings applied through ClementineDSProvider. Import from @clementine-ds/ui, not from @mantine/core directly.
Draft — Select is a Draft component. It renders correctly and all documented props are functional, but the ARIA pattern (combobox vs. listbox) has not been finalized. Token values are not yet validated against the rendered output.
Use Select when you have a short-to-medium closed list of known options and want users to pick exactly one. For open-ended type-ahead search, use a Combobox (not yet in this DS). For mutually exclusive selections with three or fewer options, consider Radio instead.

When to use

  • You have a predefined, closed list of options — a user cannot enter a value that isn’t in the list.
  • The list is short to medium in length (typically under ~50 items before UX degrades).
  • You need optional type-ahead filtering so users can narrow the list by typing.
  • You need a single selection — for multi-select, a different component is required (not yet in this DS).

When not to use

  • Free-form text with suggestions — use a Combobox or Autocomplete (not yet in this DS). Select does not allow custom values.
  • Two or three exclusive options — a Radio group is more scannable and doesn’t require opening a dropdown.
  • Boolean toggle — use a Checkbox or Switch.
  • Multiple selections from a list — use a MultiSelect (not yet in this DS).

Usage

Controlled usage

Grouped options

Custom option rendering


Props

SelectProps extends Mantine’s SelectProps directly. The table below covers the props you’ll use most often.

Interaction states


Token contract


Accessibility

  • Always supply a visible label prop. Set aria-label only when no visible label is possible.
  • When clearable is set, add an aria-label to the clear button via clearButtonProps: clearButtonProps={{ 'aria-label': 'Clear selection' }}. Without this, the clear button has no accessible name.
  • Use nothingFoundMessage when searchable is enabled — a silent empty dropdown is confusing for screen-reader users.
  • The underlying Mantine Select is built on the Combobox pattern. The exact ARIA roles (combobox + listbox) are provided by Mantine. Note: the Clementine DS spec has an open item to formally decide between the combobox and listbox ARIA patterns — see the draft status note below.
  • Keyboard navigation: Tab / Shift+Tab to move in and out of the trigger, Space or Enter to open the dropdown, ↑ / ↓ to move between options, Enter to select, Escape to close.

Draft status

Select carries a Draft status as of clementine-ds@HEAD (2026-06-08). The following items are still open:
  • ARIA pattern decision — the spec has not yet decided whether to use a combobox (text input + listbox) or listbox (button + listbox) ARIA pattern. Mantine defaults to combobox. This is under review.
  • Storybook stories are missing for: empty state, long list (overflow), and error state.
  • Token values (select.border.focus hover tint, select.option.*, select.radius) are defined in the spec but not yet validated against the rendered output.
Do not build production-critical token overrides against this component until these items are resolved.