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 des Element Interfaces spiegelt den Wert des aria-pressed Attributs wider, welches den aktuellen "gedrückten" Zustand von Umschaltschaltflächen angibt.

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 Gedrücktsein, ist aber derzeit nicht gedrückt.

"mixed"

Zeigt einen gemischten Moduswert für eine Drei-Zustand-Umschaltschaltfläche an.

"undefined"

Das Element unterstützt das Gedrücktsein nicht.

Beispiele

In diesem Beispiel ist das aria-pressed Attribut des Elements mit der ID saveChanges auf "false" gesetzt, was angibt, dass dieser Input momentan 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

BCD tables only load in the browser

Siehe auch