Select

Forms

A custom dropdown for choosing from a list of options. Supports keyboard navigation and accessible labeling.

Preview

Props API

PropTypeDefaultDescription
labelstring"Team"Visible label above the select
placeholderstring"Choose a team…"Shown when no value is selected
hintstring""Helper text below the select
errorstring""Error message when validation fails
disabledbooleanfalsePrevents interaction
requiredbooleanfalseMarks the field as required

Usage

Use a Select when there are 5 or more options. For 2–4 options, consider Radio buttons instead — they allow the user to see all choices at once. Always provide a clear placeholder or default selection.

Accessibility

  • Uses role="combobox" on the trigger and role="listbox" on the dropdown.

  • Keyboard navigation: ArrowUp/Down moves between options, Enter/Space opens/closes, Escape closes.

  • aria-expanded reflects the open state of the dropdown.

  • Selected option uses aria-selected="true".