CKTIS / HTML
aria-checked — Auswahlzustand eines Bedienelements
`aria-checked` beschreibt den Auswahlzustand eines Bedienelements mit geeigneter Rolle; es implementiert kein Checkbox-Verhalten.
Version: WAI-ARIA 1.2
Syntax
<button role="checkbox" aria-checked="mixed">All topics</button>Für eine Checkbox verwende die Zeichenfolgen true, false oder mixed. Ohne Zustandsangabe ist der Zustand undefiniert, nicht abgewählt; die Rolle checkbox verlangt eine ausdrückliche Zustandsangabe. Ein gemischter Zustand passt zu einer teilweise ausgewählten Gruppe; die Rollen radio und switch unterstützen ihn nicht. Dies ist kein durch bloße Anwesenheit aktiviertes boolesches HTML-Attribut.
Bevorzuge zunächst eine native Checkbox. Ein eigenes Bedienelement benötigt Tastaturbedienung, Fokus, Beschriftung und eine zum Zustand passende Darstellung. Eine ARIA-Änderung allein aktiviert keine zugeordneten Kontrollkästchen.
Das Beispiel verwendet einen nativen Button mit Checkbox-Semantik zur Gruppensteuerung. Anfangs ist ein Thema ausgewählt; die Aktivierung wählt beide aus und setzt den Zustand auf wahr. Der Test prüft die tatsächlichen Eingabefelder und den Zustand im Barrierefreiheitsbaum, keine bestimmte Sprachausgabe eines Screenreaders.
Beispiele
<!doctype html><meta charset="utf-8">
<button id="all" role="checkbox" aria-checked="mixed">All topics</button>
<label><input class="topic" type="checkbox" checked> HTML</label>
<label><input class="topic" type="checkbox"> CSS</label>
<output id="result"></output>
<script>
const all = document.querySelector('#all');
const topics = [...document.querySelectorAll('.topic')];
function sync() {
const n = topics.filter(input => input.checked).length;
all.setAttribute('aria-checked', n === 0 ? 'false' : n === topics.length ? 'true' : 'mixed');
}
topics.forEach(input => input.addEventListener('change', sync));
all.addEventListener('click', () => {
const checked = all.getAttribute('aria-checked') !== 'true';
topics.forEach(input => { input.checked = checked; }); sync();
});
all.click();
document.querySelector('#result').textContent = 'selected=' + topics.filter(x => x.checked).length + '; checked=' + all.getAttribute('aria-checked');
</script>Ergebnis
selected=2; checked=true
Das Ergebnis zeigt zwei ausgewählte Themen und den Zustand true. Das Verhalten liefert der Klick-Handler, nicht ARIA allein.