ElementInternals: ariaChecked-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 ariaChecked-Eigenschaft des ElementInternals-Interfaces spiegelt den Wert des aria-checked-Attributs wider, welches den aktuellen "ausgewählten" Zustand von Kontrollkästchen, Radioknöpfen und anderen Widgets mit einem auswählbaren Zustand angibt.

Hinweis: Das Setzen von aria-Attributen auf ElementInternals ermöglicht es, Standardsemantiken für ein benutzerdefiniertes Element zu definieren. Diese können durch benutzerdefinierte Attribute überschrieben werden, aber es wird sichergestellt, dass Standardsemantiken erhalten bleiben sollten, falls der Autor diese Attribute löscht oder sie überhaupt nicht hinzufügt. Für weitere Informationen siehe den Accessibility Object Model explainer.

Wert

Ein String mit einem der folgenden Werte:

"true"

Das Element ist ausgewählt.

"mixed"

Gibt einen gemischten Moduswert für ein Drei-Zustands-Kontrollkästchen oder Menüpunkt-Kontrollkästchen an.

"false"

Das Element unterstützt das Auswählen, ist aber derzeit nicht ausgewählt.

"undefined"

Das Element unterstützt das Auswählen nicht.

Beispiele

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

js
this.internals_.ariaChecked = "true";

Spezifikationen

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

Browser-Kompatibilität

Siehe auch