Skip to main content

MultiSelect

MultiSelect components allow you to make single or multiple selections from a list of options.

Accessibility Support

Out of the box, the Telerik and Kendo UI Multiselect provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.

The Multiselect is compliant with the Web Content Accessibility Guidelines (WCAG) 2.2 standards and Section 508 requirements, follows the Web Accessibility Initiative - Accessible Rich Internet Applications (WAI-ARIA) best practices for implementing the keyboard navigation and provides options for managing its focus and is tested against the most popular screen readers.

MultiSelect

ARIA Attributes

AttributeDescription
role="combobox"Announces the multiselect input.
aria-haspopup="listbox"Indicates the component has a listbox popup.
aria-expandedAnnounces the popup visibility.
aria-labelAccessible name for the multiselect.
aria-autocomplete="list"Indicates list filtering capability.
aria-describedbyPoints to the taglist element that contains the selected items.
aria-disabled="true"Rendered when the multiselect is disabled.
role="listbox"The taglist has listbox role for selected items.
aria-label|aria-labelledbyThe taglist needs an accessible name.
aria-orientation="horizontal"Specifies horizontal orientation of the taglist.
role="option"Each tag chip is an option within the taglist listbox.
aria-selected="true"Tags represent selected items and must have aria-selected=true.
role="listbox"Popup list has listbox role.
aria-label|aria-labelledbyPopup listbox must have an accessible name. Consuming code is responsible for associating with the component label via aria-labelledby.
role="option"Each list item is an option.
idReferenced by aria-controls on the input.
aria-activedescendantPoints to focused item when popup is open

Keyboard Navigation

TriggerBehavior
Typing in the inputFocuses the matched item.
Alt/Opt(Mac) + ArrowDownOpens the popup.
Alt/Opt(Mac) + ArrowUp or EscapeCloses the popup.
ArrowLeftFocuses the previous tag item in the selected list.
ArrowRightFocuses the next tag item in the selected list.
Delete or BackspaceWhen the focused item is a tag list, removes the item from the selection.
EscapeClears the value when the popup is not open.
Shift + ArrowUpCreates a range selection between the last selected or deselected item and the item that is immediately before the currently focused one. All items outside that range are deselected. The last selected or deselected item is stored when using the mouse to click an item, or when using Enter to select or deselect an item. The last selected or deselected item is reset when the value of the MultiSelect is cleared. If the there is no previously selected item, selects only the currently focused and the previous one. At the end of the operation, the focus moves to the the item that is immediately before the currently focused one.
Shift + ArrowDownCreates a range selection between the last selected or deselected item and the item that is immediately after the currently focused one. All items outside that range are deselected. The last selected or deselected item is stored when using the mouse to click an item, or when using Enter to select or deselect an item. The last selected or deselected item is reset when the value of the MultiSelect is cleared. If the there is no previously selected item, selects only the currently focused and the next one. At the end of the operation, the focus moves to the the item that is immediately after the currently focused one.
Control/Cmd(Mac) + Shift + HomeCreates a range selection from the currently focused item up to the beginning of the list. All items outside that range are deselected.
Control/Cmd(Mac) + Shift + EndCreates a range selection from the currently focused item down to the end of the list. All items outside that range are deselected.
Control/Cmd(Mac) + ASelects all items present in the list. If all items are already selected, deselects them.

UX Behavior

FeatureDescription
TagsSelected values appear as removable tag chips inside the input.
PopupClicking the input or trigger opens a filterable dropdown list.
FilteringThe list narrows as the user types in the input.
Tag removalClicking a tag's × removes that value from the selection.
PlaceholderDisplays hint text when no values are selected.
Disabled stateWhen disabled, tags cannot be added or removed.

Testing

The Multiselect has been extensively tested automatically with axe-core and manually with the most popular screen readers.

Screen Readers

The Multiselect has been tested with the following screen readers and browsers combinations:

EnvironmentTool
FirefoxNVDA
ChromeJAWS
Microsoft EdgeJAWS

Resources

Feedback