Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła