Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

aria-checked — stanje potrditvenega polja

`aria-checked` opisuje izbrano stanje kontrolnika z ustrezno vlogo; sam ne izvede delovanja potrditvenega polja.

Različica: WAI-ARIA 1.2

Sintaksa

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

Za kontrolnik checkbox uporabi nize true, false ali mixed. Odsotno stanje je nedoločeno, ne neizbrano; vloga checkbox zahteva izrecno stanje. Mešano stanje ustreza delno izbrani skupini; vlogi radio in switch ga ne podpirata. To ni logični atribut HTML, ki ga vklopi prisotnost.

Najprej izberi vgrajeno potrditveno polje. Lasten kontrolnik potrebuje upravljanje s tipkovnico, fokus, oznako in videz, skladen s stanjem. Sprememba ARIA sama ne izbere povezanih polj.

Primer za upravljanje skupine uporabi vgrajen gumb z vlogo checkbox. Najprej je izbrana ena tema; aktivacija izbere obe in stanje nastavi na resnično. Test preveri dejanski polji in stanje v drevesu dostopnosti, ne določene izgovorjene povedi bralnika.

Primeri

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

Rezultat

selected=2; checked=true

Rezultat pokaže dve izbrani temi in stanje true. Delovanje zagotovi obdelava klika, ne sama ARIA.

Viri