ElementInternals: ariaExpanded-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 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.

js
class CustomControl extends HTMLElement {
  constructor() {
    super();
    this.internals_ = this.attachInternals();
    this.internals_.ariaInvalid = "true";
  }
  // …
}

Spezifikationen

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

Browser-Kompatibilität