aria-checked

Das aria-checked Attribut zeigt den aktuellen "gecheckten" Zustand von Kontrollkästchen, Optionsfeldern und anderen Widgets an.

Hinweis: Wo möglich, verwenden Sie 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 gecheckt (true), ungecheckt (false) oder ob der Status unbestimmt (mixed) ist, was bedeutet, dass es weder gecheckt noch ungecheckt ist. Der mixed Wert wird von den dreistufigen Input-Rollen checkbox und menuitemcheckbox unterstützt.

Der mixed Wert wird nicht von radio, menuitemradio oder switch und den von diesen ererbten Elementen unterstützt. Der Wert wird false sein, wenn mixed gesetzt ist, wenn dies 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 aktivieren. JavaScript ist erforderlich, um den aria-checked Zustand zu umschalten. Wenn dieses Kontrollkästchen Teil eines absendbaren Formulars ist, ist mehr JavaScript erforderlich, um einen Namen und einen Wert festzulegen.

Das obige Beispiel könnte so 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 Gechecktsein, ist jedoch momentan nicht gecheckt.

true

Das Element ist gecheckt.

mixed

nur für checkbox und menuitemcheckbox, entspricht indeterminate, was einen gemischten Moduswert von weder gecheckt noch ungecheckt anzeigt.

undefined (Standard)

Das Element unterstützt das Gechecktsein nicht.

Zugehörige 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