CKTIS / HTML
aria-atomic — cały komunikat po zmianie
`aria-atomic` określa, czy aktualizacja obszaru live ma być przedstawiana jako całość, czy tylko jako zmieniona część.
Wersja: WAI-ARIA 1.2
Składnia
<div aria-live="polite" aria-atomic="true">Total: <span>2</span></div>Wartości ARIA to tekstowe true i false, a nie atrybut HTML włączany samą obecnością. Dla obszaru aria-live="polite" z tekstem „Total: 2 items” wartość true zachowuje kontekst, gdy zmienia się tylko liczba. Nie ustala pilności komunikatu i sama nie tworzy obszaru live.
Przy ustalaniu zachowania znaczenie ma najbliższy jawny atrybut w łańcuchu przodków. Jawne false zatrzymuje wyszukiwanie; bez odpowiedniego ustawienia domyślnie przedstawiana jest zmieniona część. Niektóre role mają wartości domyślne, np. status domyślnie jest atomowy.
Przykład zmienia wyłącznie zawartość span, pozostawiając pełny komunikat. Sprawdzono DOM i właściwość atomowości w drzewie dostępności Chromium. Nie dowodzi to konkretnej wypowiedzi każdego czytnika: technologie wspomagające mogą łączyć aktualizacje. Nie twórz nadmiernie dużych regionów, które powtarzałyby długi tekst.
Przykłady
<!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>Wynik
atomic=true; region=Total: 3 items
Test potwierdza przekazanie semantyki i końcową treść regionu; rzeczywisty sposób odczytu wymaga testu z wybranym czytnikiem.