CKTIS / HTML
aria-atomic — oznámenie celej zmenenej správy
`aria-atomic` určuje, či sa aktualizácia živej oblasti predstaví ako celok alebo iba ako zmenená časť.
Verzia: WAI-ARIA 1.2
Syntax
<div aria-live="polite" aria-atomic="true">Total: <span>2</span></div>ARIA používa reťazce true a false, nie booleovský atribút HTML zapnutý prítomnosťou. V oblasti aria-live="polite" s „Total: 2 items“ zachová true kontext, keď sa mení iba číslo. Neurčuje naliehavosť a samo nevytvára živú oblasť.
Rozhoduje najbližší explicitný atribút v reťazci predkov. Explicitné false zastaví hľadanie; bez použiteľného nastavenia je predvolená zmenená časť. Niektoré roly poskytujú implicitné hodnoty: status je štandardne atomický.
Príklad mení iba span a zachováva celú správu. Overil sa DOM aj atomická vlastnosť v strome prístupnosti Chromium. To nezaručuje konkrétnu vetu každej čítačky, ktorá môže aktualizácie zlúčiť. Vyhni sa veľkým oblastiam opakujúcim dlhý text.
Prí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ýsledok
atomic=true; region=Total: 3 items
Test overuje sprístupnenú sémantiku a konečný obsah. Skutočnú reč treba overiť zvolenou čítačkou.