KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

aria-checked — aangevinkte toestand van een bedieningselement

`aria-checked` beschrijft de aangevinkte toestand van een bedieningselement met een geschikte rol; het implementeert geen selectievakgedrag.

Versie: WAI-ARIA 1.2

Syntax

<button role="checkbox" aria-checked="mixed">All topics</button>

Gebruik voor een selectievak de tekenreeksen true, false of mixed. Zonder toestand is deze ongedefinieerd, niet uitgevinkt; de rol checkbox vereist een expliciete toestand. Gemengd past bij een gedeeltelijk gekozen groep; de rollen radio en switch ondersteunen dit niet. Dit is geen HTML-boolean die alleen door aanwezigheid aanstaat.

Kies eerst voor een native selectievak. Een eigen bedieningselement vereist toetsenbordbediening, focus, een label en een uiterlijk dat bij de toestand past. Alleen ARIA veranderen vinkt gekoppelde invoervelden niet aan.

Het voorbeeld gebruikt een native knop met checkbox-semantiek om een groep te bedienen. Aanvankelijk is één onderwerp aangevinkt; activeren vinkt beide aan en zet de toestand op waar. De test controleert de echte invoervelden en de toestand in de toegankelijkheidsboom, geen bepaalde uitspraak van een schermlezer.

Voorbeelden

<!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>

Resultaat

selected=2; checked=true

Het resultaat toont twee aangevinkte onderwerpen en de toestand true. De klikafhandeling levert het gedrag, niet ARIA alleen.

Bronnen