Select lets users choose one value from a list of available options.
Click trigger or press Enter/Space to open. Arrow keys navigate options. Enter selects. Escape closes.
<Select.Root>
<Select.Trigger placeholder='Choose a fruit…' />
<Select.Content>
<Select.Item value='apple' label='Apple'>Apple</Select.Item>
</Select.Content>
</Select.Root>Options organized in groups with labels. Group labels are announced by screen readers.
<Select.Root>
<Select.Trigger placeholder='Select a food…' />
<Select.Content>
<Select.Group>
<Select.Label>Fruits</Select.Label>
<Select.Item value='apple' label='Apple'>Apple</Select.Item>
</Select.Group>
</Select.Content>
</Select.Root>Individual options can be disabled. Arrow keys skip disabled options.
<Select.Root>
<Select.Trigger placeholder='Choose a plan…' />
<Select.Content>
<Select.Item value='free' label='Free'>Free</Select.Item>
<Select.Item value='pro' disabled label='Pro (sold out)'>Pro (sold out)</Select.Item>
</Select.Content>
</Select.Root>Parent manages the selected value. External buttons can change the selection.
const [value, setValue] = useState('');
<Select.Root value={value} onChange={(nextValue) => setValue(nextValue)}>
<Select.Trigger placeholder='Select size…' />
<Select.Content>
<Select.Item value='small' label='Small'>Small</Select.Item>
</Select.Content>
</Select.Root>Entire select can be disabled. Trigger cannot be activated.
<Select.Root disabled>
<Select.Trigger placeholder='Disabled select' />
<Select.Content>
<Select.Item value='a' label='Option A'>Option A</Select.Item>
</Select.Content>
</Select.Root>Select with required prop for form validation. Uses aria-required.
<Select.Root required>
<Select.Trigger placeholder='Required field *' />
<Select.Content>
<Select.Item value='opt1' label='Option 1'>Option 1</Select.Item>
</Select.Content>
</Select.Root>