CKTIS / HTML
aria-atomic — eine geänderte Meldung vollständig ausgeben
`aria-atomic` bestimmt, ob eine Live-Region nach einer Änderung vollständig oder nur mit dem geänderten Teil präsentiert werden soll.
Version: WAI-ARIA 1.2
Syntax
<div aria-live="polite" aria-atomic="true">Total: <span>2</span></div>ARIA verwendet die Zeichenfolgen true und false, kein durch Anwesenheit aktiviertes HTML-Attribut. Bei aria-live="polite" und „Total: 2 items“ erhält true den Zusammenhang, wenn sich nur die Zahl ändert. Es legt weder Dringlichkeit fest noch erzeugt es allein eine Live-Region.
Relevant ist das nächste explizite Attribut in der Vorfahrenkette. Explizites false beendet die Suche; ohne passende Einstellung gilt der geänderte Teil als Standard. Manche Rollen haben implizite Werte, beispielsweise ist status standardmäßig atomar.
Das Beispiel ändert nur den Inhalt des span und erhält den ganzen Satz. DOM und Atomizität im Chromium-Barrierefreiheitsbaum wurden geprüft. Das garantiert keine konkrete Sprachausgabe jedes Screenreaders: Hilfstechnologien dürfen Änderungen zusammenfassen. Vermeide übergroße Regionen, die lange Texte wiederholen.
Beispiele
<!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>Ergebnis
atomic=true; region=Total: 3 items
Geprüft werden exponierte Semantik und endgültiger Inhalt. Tatsächliche Sprache erfordert einen Test mit dem gewählten Screenreader.