Skip to main content

Usage

TypePurpose
DropdownUser needs to pick one option from a list.
Filter DropdownWhen a list contains more than 25 items, use filtering to help find options from the list. May only be used with Dropdown or Multi-select Dropdown. Cannot be used with Inline Dropdown.
Multi-select DropdownUser needs to select multiple options from a Dropdown.
Inline DropdownA stylized Dropdown that can be formatted to appear inline with other content and allows the user to select one option.
Inline Multi-select DropdownA stylized Dropdown that can be formatted to appear inline with other content and allows the user to select more than one option.

Dropdowns can also be used as menus. This can be seen in Tabs, when used in a smaller screen size, collapses into a Dropdown.

Content

Labels

Labels inform users what to expect in the list of Dropdown options. Use clear labels for the Dropdown trigger so that users understand the purpose. Keep the label short and concise by limiting it to a single line of text.

Describe the Dropdown option succinctly in one line of text. Never use images or icons within a Dropdown. Avoid having multiple lines of text in a Dropdown, but if text wrapping is necessary, limit it to two lines and an ellipsis (...) for overflow content. We recommend presenting the options in alphabetical order.

Interaction

By default, the Dropdown displays a label when closed. An open Dropdown appears on click rather than on hover. Open Dropdown drawers should appear above all other UI elements. They can be dismissed by clicking outside of the Dropdown item or on the parent element.

Interactions for Inline Dropdown are the same as above, however we currently don't support an Inline Filter Dropdown (single or Multi-select).

Selecting an item from the Dropdown will close the drawer and the selected option will replace the label.

Multi-select Dropdown

The label remains persistent within the Dropdown. Once the user chooses an option from the list, a number badge will appear to the left of the label containing the total number of selected items. Selected options float to the top of the list in alphanumeric order.

multiselect dropdown

Clear all

To clear all selected items from a list, hover over the number badge and click the "x" icon next to the value. To help with clarity, a browser tooltip appears when the user hovers over the "x" (or close) icon to indicate the click action results.

clear all on multiselect dropdown

Filter Dropdown

By default, the Dropdown displays a label when closed. When the user hovers over the label area, a text cursor will appear. The drawer opens on click (anywhere in the field) and the user can type to filter through the list of options below. Once the user begins typing, the close (x) icon will appear to the right of the label. This will clear any user-inputted text. Selecting an item from the Dropdown will close the drawer and the selected option will replace the default label.

filter dropdown interactions

Multi-select Filter Dropdown

This variation of Dropdown follows the same interaction patterns described above with the following exceptions:

  • The label will remain persistent except when the user is inputting text.
  • Selected options will appear at the top of the list.
  • The drawer does not close once the user makes a selection. The user will need to click outside of the Dropdown or on the parent element to close the drawer.

multiselect filter dropdown interactions