CKTIS / HTML
aria-atomic — predstavljanje cijele promijenjene poruke
`aria-atomic` određuje predstavlja li se ažuriranje žive regije kao cjelina ili samo kao promijenjeni dio.
Verzija: WAI-ARIA 1.2
Sintaksa
<div aria-live="polite" aria-atomic="true">Total: <span>2</span></div>ARIA koristi nizove true i false, a ne logički atribut HTML koji uključuje sama prisutnost. U regiji aria-live="polite" s »Total: 2 items« vrijednost true čuva kontekst kad se promijeni samo broj. Ne određuje hitnost i sama ne stvara živu regiju.
Odlučuje najbliži izričiti atribut u lancu predaka. Izričiti false zaustavlja traženje; bez odgovarajuće postavke zadani je opseg promijenjeni dio. Neke uloge daju implicitne vrijednosti, primjerice status je zadano atomaran.
Primjer mijenja samo span i čuva cijelu poruku. Provjereni su DOM i atomsko svojstvo u stablu pristupačnosti Chromiuma. To ne jamči određenu izgovorenu rečenicu svakog čitača: pomoćna tehnologija može spajati ažuriranja. Izbjegni velike regije koje ponavljaju dug tekst.
Primjeri
<!doctype html><meta charset="utf-8">
<div id="status" aria-live="polite" aria-atomic="true">Total: <span id="count">2</span> items</div>
<output id="result"></output>
<script>
document.querySelector('#count').textContent = '3';
const status = document.querySelector('#status');
document.querySelector('#result').textContent =
'atomic=' + status.getAttribute('aria-atomic') + '; region=' + status.textContent;
</script>Rezultat
atomic=true; region=Total: 3 items
Test potvrđuje izloženu semantiku i konačni sadržaj. Stvarni govor treba provjeriti odabranim čitačem zaslona.