ARIA: aria-checked Attribut

Dasaria-checked Attribut gibt den aktuellen "checked"-Zustand von Kontrollkästchen, Optionsfeldern und anderen Widgets an.

Hinweis:Verwenden Sie nach Möglichkeit ein HTML<input> Element mittype="checkbox" undtype="radio", da diese eingebaute Semantik haben und keine ARIA-Attribute erfordern.

Beschreibung

Dasaria-checked Attribut gibt an, ob das Element ausgewählt (true), nicht ausgewählt (false) oder ob der ausgewählte Status unbestimmt (mixed) ist, was bedeutet, dass es weder ausgewählt noch nicht ausgewählt ist. Dermixed Wert wird von den drei Zustands-Eingaberollencheckbox undmenuitemcheckbox unterstützt.

Dermixed Wert wird nicht vonradio,menuitemradio oderswitch und Elementen, die davon erben, unterstützt. Der Wert wirdfalse sein, wennmixed gesetzt ist, wenn es nicht unterstützt wird.

html

<span  role="checkbox"   aria-checked="false"  tabindex="0"  aria-labelledby="chk15-label"></span><label>Subscribe to the newsletter</label>

Dastabindex Attribut ist erforderlich, um den Fokus zu ermöglichen. JavaScript ist erforderlich, um denaria-checked Status umzuschalten. Und, wenn dieses Kontrollkästchen Teil eines einreichbaren Formulars ist, ist weiteres JavaScript erforderlich, um einen Namen und einen Wert festzulegen.

Das Obige könnte wie folgt geschrieben werden:

html

<input type="checkbox" name="Subscribe" /><label for="chk15-label">Subscribe to the newsletter</label>

Durch die Verwendung des<input> Elements mittype="checkbox" anstelle von ARIA ist kein JavaScript erforderlich.

Werte

false: Das Element unterstützt das Ausgewähltsein, ist aber derzeit nicht ausgewählt.
true: Das Element ist ausgewählt.
mixed: Nur fürcheckbox undmenuitemcheckbox, entsprichtindeterminate, was einen gemischten Moduswert angibt, der weder ausgewählt noch nicht ausgewählt ist.
undefined (Standard): Das Element unterstützt das Ausgewähltsein nicht.

Zugehörige Rollen

Verwendet in Rollen:

Zugehörige Schnittstellen

Element.ariaChecked: DieariaChecked Eigenschaft, Teil derElement Schnittstelle, spiegelt den Wert desaria-checked Attributs wider.
ElementInternals.ariaChecked: DieariaChecked Eigenschaft, Teil derElementInternals Schnittstelle, spiegelt den Wert desaria-checked Attributs wider.

myHTMLElement.ariaChecked = true;

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA) # aria-checked
Unknown specification

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen •Fehler mit dieser Übersetzung melden

Movatterモバイル変換