Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje