Element: ariaMultiSelectable-Eigenschaft

Baseline 2023
Newly available

Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die ariaMultiSelectable-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-multiselectable-Attributs wider, welches angibt, dass der Benutzer mehr als ein Element aus den aktuellen auswählbaren Nachkommen auswählen kann.

Hinweis: Verwenden Sie nach Möglichkeit ein HTML-<select>-Element, da dieses eingebaute Semantik hat und keine ARIA-Attribute benötigt.

Wert

Ein String mit einem der folgenden Werte:

"true"

Mehr als ein Element kann gleichzeitig ausgewählt werden.

"false"

Es kann nur ein Element ausgewählt werden.

Beispiele

In diesem Beispiel wird das aria-multiselectable-Attribut auf dem Element mit der ID listbox1 auf "true" gesetzt, was anzeigt, dass dieses Eingabefeld mehrere ausgewählte Elemente akzeptiert. Mit ariaMultiSelectable aktualisieren wir den Wert auf "false".

html
<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>
js
let el = document.getElementById("listbox1");
console.log(el.ariaMultiSelectable); // "true"
el.ariaMultiSelectable = "false";
console.log(el.ariaMultiSelectable); // "false"

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariamultiselectable

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch