ElementInternals: ariaPressed-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 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.
class CustomControl extends HTMLElement {
constructor() {
super();
this.internals_ = this.attachInternals();
this.internals_.ariaPressed = "true";
}
// …
}
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariapressed |