Element: ariaExpanded-Eigenschaft
Baseline
2023
Neu verfügbar
Seit October 2023 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
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 |