Element: 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 der Element-Schnittstelle reflektiert den Wert des aria-pressed-Attributs, welches den aktuellen "gedrückten" Zustand von Umschaltknöpfen anzeigt.
Wert
Ein String mit einem der folgenden Werte:
"true"-
Das Element ist gedrückt.
"false"-
Das Element unterstützt das Drücken, ist aber momentan nicht gedrückt.
"mixed"-
Gibt einen gemischten Moduswert für einen Drei-Zustand-Umschaltknopf an.
"undefined"-
Das Element unterstützt das Drücken nicht.
Beispiele
In diesem Beispiel wird das aria-pressed-Attribut des Elements mit der ID saveChanges auf "false" gesetzt, was anzeigt, dass dieser Eingang derzeit nicht gedrückt ist. Mit ariaPressed aktualisieren wir den Wert auf "true".
<div id="saveChanges" tabindex="0" role="button" aria-pressed="false">Save</div>
let el = document.getElementById("saveChanges");
console.log(el.ariaPressed); // "false"
el.ariaPressed = "true";
console.log(el.ariaPressed); // "true"
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariapressed |