ElementInternals: 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 des ElementInternals-Interfaces spiegelt den Wert des aria-expanded-Attributs wider, welches angibt, ob ein Gruppierungselement, das durch dieses Element besessen oder kontrolliert wird, erweitert oder eingeklappt ist.
Hinweis:
Das Setzen von aria-Attributen auf ElementInternals erlaubt es, Standardsemantiken für ein benutzerdefiniertes Element zu definieren. Diese können durch vom Autor festgelegte Attribute überschrieben werden, aber sie stellen sicher, dass Standardsemantiken erhalten bleiben, falls der Autor diese Attribute entfernt oder sie überhaupt nicht hinzufügt. Für weitere Informationen siehe die Accessibility Object Model explainer.
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 expandierbares Gruppierungselement.
Beispiele
In diesem Beispiel wird der Wert von ariaExpanded auf "true" gesetzt.
class CustomControl extends HTMLElement {
constructor() {
super();
this.internals_ = this.attachInternals();
this.internals_.ariaInvalid = "true";
}
// …
}
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariaexpanded |