On this page

Dropdown Multiselect

Overview

Dropdown Multiselect allow users to select multiple items from a list of predefined items in a dropdown menu. Items are displayed as checkbox items to make the user understand the multiselection capability.

Usage

When to use:

  • Users need to select items from a long list of items.
  • The values of the option list are secondary information and do not need to be displayed right away.

When not to use:

  • Users need to select from a list of two options, where one of the options can be implied as on and off or yes and no. Consider using a toggle switch control instead.
  • You want the user to select one entry only. In this case, use the text input or combo box instead.

Sources and references

Anatomy

This component is almost entirely configurable, thanks to the Figma ‘Variants’ feature. To find out how you can use this flexible component, check out the following areas within the component to customise. All the sub-components can be accessed via the component’s layers list or by double-clicking in the corresponding zones highlighted with the purple boxes.

Want to learn more? Check out the Figma Variants Tutorial on YouTube, to understand how we build flexible components with Variants.

Properties

From the design point of view, each component has a number of options. These options and their names are platform agnostic, and each implementation should adapt these to fit into their framework. In Figma, these are defined as properties that help define each variant.

◇◇❖ Component: Dropdown multiselect

PropertyValuesDefault
sizesmall / medium / largeMedium
statedefault / hover / filledDefault
disabledfalse / trueFalse
errorfalse / trueFalse
*isOpenfalse / trueFalse
searchablefalse / trueFalse
placementbottom / topFalse

Composition

This component is composed of other TDS elements (Dropdown Menu & Text Input) and therefore we recommend you refer to the documentation of those components to ensure that you use the component in the most appropriate way.

❖ Sub-component: Text input
❖ Sub-component: Dropdown menu

Behaviour

Note: this component is composed of other TDS elements (Dropdown Menu & Text Input) and therefore we recommend you refer to the documentation of those components to ensure that you use the component in the most appropriate way.

Sizes

Dropdown multiselects are available in three sizes to cater for the diverse range of use cases and devices that our business uses.

When the menu is open, each option in the menu should be the same height as the field. Use a consistent size of form components on the same page.

For example, if you are using a medium size dropdown multiselect, also use the same size text inputs, buttons, and so on.

Filterable input

When the dropdown menu gets longer than 10-20 items, a searchable input can allow a user to search items easier through a large list of choices instead of scrolling down.

Autosuggest & autocomplete

The two types of selection suggestion should not be confused.

  • Autosuggestion: filters through the list of items to give the user a smaller range of options to choose from.
  • Autocomplete: when the input field puts forward a way to complete the sentence or the word.

Completed input

When the user has selected an option, the dropdown multiselect should return to the default state with the selection as replacement of the placeholder. This is the “filled” state.

When the user opens back the dropdown, the component should highlight the last selection with the hover/active state as default.

To indicate the values in the field, we recommend using commas to separate items, or use removable tags to display the values.

Find associated documentation on tags here.

Usage Guidelines

Choosing radio buttons over dropdowns

  • Don’t: use dropdowns for 5 options or less.
  • Do: use radio buttons instead.

Choosing text inputs over dropdowns

  • Don’t: propose a dropdown if selecting an option takes more time than typing.
  • Do: use text inputs (for example) instead.

Avoid dropdowns for binary choices (On/Off - Yes/No - …)

  • Don’t: make the user select between two binary and opposed options in a list.
  • Do: use a toggle switch or a checkbox instead.

Avoid dropdowns for numeric choices

  • Don’t: use a dropdown if the user has to select in a list of numeric items (years, numbers, …)
  • Do: prefer using a text input (see below) to let them type in, or use a stepper. (coming soon)

Help the user for long lists of choices

  • Don’t: give the user a too long, scrollable list of options to choose from without helping them.
  • Do: use a solution like auto-suggest or auto-complete to give them opportunity to search in your list.

Component Architecture

Link to Figma file