ElementInternals: ariaPressed-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 ariaPressed-Eigenschaft des ElementInternals-Interfaces spiegelt den Wert des aria-pressed-Attributs wider, das den aktuellen "gedrückten" Zustand von Umschaltknöpfen angibt.

Hinweis: Das Setzen von aria-Attributen auf ElementInternals ermöglicht es, standardmäßige Semantiken für ein benutzerdefiniertes Element zu definieren. Diese können durch vom Autor definierte Attribute überschrieben werden, stellen jedoch sicher, dass die Standardsemantiken beibehalten werden, falls der Autor diese Attribute löscht oder sie überhaupt nicht hinzufügt. Weitere Informationen finden Sie im Accessibility Object Model explainer.

Wert

Ein String mit einem der folgenden Werte:

"true"

Das Element ist gedrückt.

"false"

Das Element unterstützt es, gedrückt zu werden, ist aber derzeit nicht gedrückt.

"mixed"

Gibt einen gemischten Moduswert für einen Drei-Zustand-Umschaltknopf an.

"undefined"

Das Element unterstützt es nicht, gedrückt zu werden.

Beispiele

In diesem Beispiel wird der Wert von ariaPressed auf "true" gesetzt.

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch