COMPONENTS
Dropdown
Dropdown allows a user to choose one action from a collection of actions.
The Dropdown menu is triggered by a Dropdown button. Dropdown buttons can use a single button or a split button with a toggle for triggering the menu.
- Dropdown Button
- Call to Action
- Toggle Icon
- Dropdown Menu
- Menu Item
There are two types of dropdowns – single button and split button. Both types can optionally have a leading icon.
Dropdowns can have one of five action styles applied — primary, secondary, info, contrast, and destructive.
Dropdowns can have bold, subtle, or minimal emphasis.
The toggle icon can be replaced with a custom icon when a single icon dropdown button is needed.
By default the dropdown menu is aligned to the bottom left of the dropdown button when opened. Alternate placements are available depending on the needs of the design and are shown below. Additionally, the menu can be set to automatically adjust position to avoid being truncated by the browser or container edge.
Dropdown button has five possible states — enabled, hover, active, focus and disabled. The same states are applied to the split button.
The dropdown menu inherits all the states from Menu the component — enabled, hover, active, focus, selected and disabled.
Dropdown can be displayed in extra large, large, medium and small sizes.
- Menu items should be organized in a logical way that is easily communicated to the user. Best practices include listing alphabetically or grouping related actions.
- If the list of items is longer than 15 items, consider using Select to allow the user to filter the items via direct input.
- When using the split dropdown button, the left button should be the first action from the collection and not repeated in the menu.
Contents