ARIA: aria-checked Attribut

Das aria-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 mit type="checkbox" und type="radio", da diese eingebaute Semantik haben und keine ARIA-Attribute erfordern.

Beschreibung

Das aria-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. Der mixed Wert wird von den drei Zustands-Eingaberollen checkbox und menuitemcheckbox unterstützt.

Der mixed Wert wird nicht von radio, menuitemradio oder switch und Elementen, die davon erben, unterstützt. Der Wert wird false sein, wenn mixed gesetzt ist, wenn es nicht unterstützt wird.

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

Das tabindex Attribut ist erforderlich, um den Fokus zu ermöglichen. JavaScript ist erforderlich, um den aria-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" id="chk15-label" name="Subscribe" />
<label for="chk15-label">Subscribe to the newsletter</label>

Durch die Verwendung des <input> Elements mit type="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ür checkbox und menuitemcheckbox, entspricht indeterminate, 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

Die ariaChecked Eigenschaft, Teil der Element Schnittstelle, spiegelt den Wert des aria-checked Attributs wider.

ElementInternals.ariaChecked

Die ariaChecked Eigenschaft, Teil der ElementInternals Schnittstelle, spiegelt den Wert des aria-checked Attributs wider.

js
myHTMLElement.ariaChecked = true;

Spezifikationen

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

Siehe auch