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.
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).Selectdoes not allow custom values. - Two or three exclusive options — a
Radiogroup is more scannable and doesn’t require opening a dropdown. - Boolean toggle — use a
CheckboxorSwitch. - 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
labelprop. Setaria-labelonly when no visible label is possible. - When
clearableis set, add anaria-labelto the clear button viaclearButtonProps:clearButtonProps={{ 'aria-label': 'Clear selection' }}. Without this, the clear button has no accessible name. - Use
nothingFoundMessagewhensearchableis enabled — a silent empty dropdown is confusing for screen-reader users. - The underlying Mantine
Selectis built on theComboboxpattern. The exact ARIA roles (combobox+listbox) are provided by Mantine. Note: the Clementine DS spec has an open item to formally decide between thecomboboxandlistboxARIA patterns — see the draft status note below. - Keyboard navigation:
Tab/Shift+Tabto move in and out of the trigger,SpaceorEnterto open the dropdown,↑/↓to move between options,Enterto select,Escapeto 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) orlistbox(button + listbox) ARIA pattern. Mantine defaults tocombobox. This is under review. - Storybook stories are missing for: empty state, long list (overflow), and error state.
- Token values (
select.border.focushover tint,select.option.*,select.radius) are defined in the spec but not yet validated against the rendered output.