ARIA: aria-checked Attribut

Beschreibung

Das aria-checked Attribut gibt an, ob das Element gecheckt (true), nicht gecheckt (false) oder ob der Status des Gechecktseins unbestimmt (mixed) ist, was bedeutet, dass es weder gecheckt noch nicht gecheckt ist. Der mixed Wert wird von den drei Ausgangszustandsrollen checkbox und menuitemcheckbox unterstützt.

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

<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 Status umzuschalten. Und wenn dieses Kontrollkästchen Teil eines absendbaren Formulars ist, ist mehr JavaScript erforderlich, um einen Namen und einen Wert festzulegen.

Das obige hätte geschrieben werden können als:

<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 derzeit nicht gecheckt.

true

Das Element ist gecheckt.

mixed

Nur für checkbox und menuitemcheckbox, gleichbedeutend mit indeterminate, was einen gemischten Moduswert anzeigt, der weder gecheckt noch nicht gecheckt ist.

undefined (default)

Das Element unterstützt das Gechecktsein nicht.

Zugehörige Rollen

Verwendet in Rollen:

• checkbox
• menuitemcheckbox
• menuitemradio
• option
• radio
• switch

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.

myHTMLElement.ariaChecked = true;

Spezifikationen

Siehe auch

• <input type="checkbox">
• <input type="radio">
• aria-pressed
• aria-selected
• Zwei Zustand Kontrollkästchen Beispiel - w3.org
• Mix-Zustand Kontrollkästchen Beispiel - w3.org