Dropdown component in Office UI Fabric

A Dropdown is a list of options which is shown by clicking a dropdown button. Use Dropdowns to simplify the UI design, and when users should make a choice within the UI. When the list collapses, the selected items is visible. To change the selected item, users open the list, and select a new value.

Example: Dropdown in a task pane

An image showing the Dropdown

Best Practices

Do Don't
Use a Dropdown when the default selected option is more likely to be selected than other options. By contrast, ChoiceGroup or radio buttons show all choices thereby putting equal emphasis on all options. Don't use Dropdowns where all options are equally likely to be selected.
Use a Dropdown when there are multiple choices that can be collapsed into one field. Also, use Dropdowns for long lists of items, or when screen space is constrained. Don’t use Dropdowns if there are fewer than two choices. Instead, use a checkbox.
Use shortened statements or words in Dropdowns.


Variation Description Example
Basic uncontrolled Dropdown Use when many options are available for selection. Basic uncontrolled Dropdown image
Disabled uncontrolled Dropdown with defaultSelectedKey Disabled state of the Dropdown. Disabled uncontrolled Dropdown with defaultSelectedKey image
Controlled Dropdown Use when the default selected item is influenced by another location in your UI, and the selected item in the DropDown must be maintained. Controlled Dropdown image


For details, see Dropdown and Getting started with Fabric React code sample.

Additional resources