Skip to the page

UI

Dropdown

A dropdown picks one item from a long list, such as a team.

In use

Choosing one of 30 teams in the Filter panel.
A league, with only a few choices, uses option chips instead.

Anatomy

  1. FieldRounded 10px with a control-coloured outline, at least 44px tall.
  2. ValueThe current choice.
  3. ChevronThe chevron Icon, in place of the browser's arrow.

When to use it

Use a dropdown when there are more than about five choices.

When not to use it

For five choices or fewer, use option chips.

Accessibility

The dropdown is the browser’s own list, named by its field, so it works with the keyboard and screen readers like the device’s lists.

Tokens

In code: Dropdown and OptionChips in src/ds/components/Filter/Options.tsx

Tokens
TokenWhat it sets
--ds-controlThe outline.
--ds-radius-smThe corners.
--ds-touch-targetThe 44px minimum height.