Element: 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 der Element-Schnittstelle reflektiert den Wert des aria-pressed-Attributs, welches den aktuellen "gedrückten" Zustand von Umschaltknöpfen anzeigt.

Hinweis: Verwenden Sie nach Möglichkeit ein HTML-<input> Element mit type="button" oder das <button> Element, da diese eingebaute Semantik haben und keine ARIA-Attribute benötigen.

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".

html
<div id="saveChanges" tabindex="0" role="button" aria-pressed="false">Save</div>
js
let el = document.getElementById("saveChanges");
console.log(el.ariaPressed); // "false"
el.ariaPressed = "true";
console.log(el.ariaPressed); // "true"

Spezifikationen

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

Browser-Kompatibilität

Siehe auch