ElementInternals: ariaChecked-Eigenschaft
Baseline
2023
Neu verfügbar
Seit October 2023 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die ariaChecked-Eigenschaft des ElementInternals-Interfaces spiegelt den Wert des aria-checked-Attributs wider, welches den aktuellen "geprüften" Zustand von Kontrollkästchen, Optionsfeldern und anderen Widgets, die einen geprüften Zustand haben, anzeigt.
Hinweis:
Das Setzen von aria-Attributen auf ElementInternals erlaubt es, die Standardsemantik eines benutzerdefinierten Elements zu definieren. Diese können durch vom Autor definierte Attribute überschrieben werden, stellen jedoch sicher, dass die Standardsemantik beibehalten wird, sollte der Autor diese Attribute löschen oder überhaupt nicht hinzufügen. Weitere Informationen finden Sie im Accessibility Object Model Explainer.
Wert
Ein String mit einem der folgenden Werte:
"true"-
Das Element ist aktiviert.
"mixed"-
Gibt einen gemischten Moduswert für ein Drei-Zustand-Kontrollkästchen oder Menüelement-Kontrollkästchen an.
"false"-
Das Element unterstützt das aktiviert sein, ist aber derzeit nicht aktiviert.
"undefined"-
Das Element unterstützt das aktiviert sein nicht.
Beispiele
In diesem Beispiel wird der Wert von ariaChecked auf "true" gesetzt.
class CustomControl extends HTMLElement {
constructor() {
super();
this.internals_ = this.attachInternals();
this.internals_.ariaChecked = "true";
}
// …
}
Spezifikationen
| Spezifikation |
|---|
| Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariachecked |