CKTIS / HTML
aria-atomic — předání celé změněné zprávy
`aria-atomic` určuje, zda se aktualizace živé oblasti představí jako celek, nebo pouze jako změněná část.
Verze: WAI-ARIA 1.2
Syntaxe
<div aria-live="polite" aria-atomic="true">Total: <span>2</span></div>ARIA používá řetězce true a false, nikoli booleovský HTML atribut aktivovaný přítomností. V oblasti aria-live="polite" s „Total: 2 items“ zachová true kontext při změně samotného čísla. Neurčuje naléhavost a samo nevytvoří živou oblast.
Rozhoduje nejbližší explicitní atribut v řetězci předků. Explicitní false hledání zastaví; bez odpovídajícího nastavení je výchozí změněná část. Některé role mají implicitní hodnoty, například status je standardně atomický.
Příklad mění jen span a zachovává celou zprávu. Ověřen byl DOM i atomická vlastnost ve stromu přístupnosti Chromium. To nezaručuje konkrétní větu každé čtečky: pomocné technologie mohou aktualizace slučovat. Vyhni se velkým oblastem opakujícím dlouhý text.
Příklady
<!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>Výsledek
atomic=true; region=Total: 3 items
Test ověřuje zpřístupněnou sémantiku a konečný obsah. Skutečnou řeč je třeba ověřit zvolenou čtečkou.