Element: ariaExpanded-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2023 browserübergreifend verfügbar.
Die ariaExpanded-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-expanded-Attributs wider, das anzeigt, ob ein Gruppierungselement, das von diesem Element besitzt oder kontrolliert wird, erweitert oder eingeklappt ist.
Wert
Ein String mit einem der folgenden Werte:
"true"-
Das Gruppierungselement, das dieses Element besitzt oder kontrolliert, ist erweitert.
"false"-
Das Gruppierungselement, das dieses Element besitzt oder kontrolliert, ist eingeklappt.
"undefined"-
Das Element besitzt oder kontrolliert kein erweiterbares Gruppierungselement.
Beispiele
In diesem Beispiel wird das aria-expanded-Attribut auf dem Element mit der ID animal auf "false" gesetzt. Mit ariaExpanded aktualisieren wir den Wert auf "true".
<div class="animals-combobox">
<label for="animal">Animal</label>
<input
id="animal"
type="text"
role="combobox"
aria-autocomplete="list"
aria-expanded="false"
aria-haspopup="true" />
<button id="animals-button" tabindex="-1" aria-label="Open">▽</button>
<ul id="animals-listbox" role="listbox" aria-label="Animals">
<li id="animal-cat" role="option">Cat</li>
<li id="animal-dog" role="option">Dog</li>
</ul>
</div>
let el = document.getElementById("animal");
console.log(el.ariaExpanded); // false
el.ariaExpanded = "true";
console.log(el.ariaExpanded); // true
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariaexpanded |