WAI-ARIA: aria-multiselectable (Property) • Digital A11y

Indicates that the user may select more than one item from the current selectable descendants.

Widget property

Description

Indicates that the user may select more than one item from the current selectable descendants.

Authors SHOULD ensure that selected descendants have the aria-selected attribute set to true, and selectable descendant have the aria-selected attribute set to false. Authors SHOULD NOT use the aria-selected attribute on descendants that are not selectable.

Note: Lists and trees are examples of roles that might allow users to select more than one item at a time.

Example

Example coming soon

Characteristics

Used in Roles

grid
listbox
tablist
tree

Inherits into Roles

treegrid

Value

True/False
- Value representing either true or false. The default value for this value type is False, unless otherwise specified.

False (default)
- Only one item can be selected
True:
- More than one item in the widget may be selected at a time.

Semantic HTML

Use the HTML5 multiple attribute of the <select> tag.

<select multiple>
<option value="volvo">Volvo</option>
<option value="saab">Saab</option>
<option value="opel">Opel</option>
<option value="audi">Audi</option>
</select>

Reference

W3C (opens new window)