Element.ariaMultiSelectable
The ariaMultiSelectable
property of the Element
interface reflects the value of the aria-multiselectable
attribute, which indicates that the user may select more than one item from the current selectable descendants.
Note: Where possible use an HTML <select>
element as this has built in semantics and does not require ARIA attributes.
Value
A DOMString
with one of the following values:
"true"
-
More than one item may be selected at a time.
"false"
-
Only one item may be selected.
Examples
In this example the aria-multiselectable
attribute on the element with an ID of listbox1
is set to "true" indicating that this input accepts multiple selected items. Using ariaMultiSelectable
we update the value to "false".
<div role="listbox" tabindex="0" id="listbox1"
aria-multiselectable="true" aria-labelledby="listbox1label" aria-activedescendant="listbox1-1">
<div role="option" id="listbox1-1" class="selected" aria-selected="true">Green</div>
<div role="option" id="listbox1-2">Orange</div>
<div role="option" id="listbox1-3">Red</div<
</div>
let el = document.getElementById('listbox1');
console.log(el.ariaMultiSelectable); // "true"
el.ariaMultiSelectable = "false"
console.log(el.ariaMultiSelectable); // "false"
Specifications
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) 1.2 # dom-ariamixin-ariamultiselectable |
Browser compatibility
BCD tables only load in the browser