Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

aria-atomic — presentare l’intero messaggio modificato

`aria-atomic` specifica se l’aggiornamento di una regione live va presentato per intero oppure solo nella parte modificata.

Versione: WAI-ARIA 1.2

Sintassi

<div aria-live="polite" aria-atomic="true">Total: <span>2</span></div>

ARIA usa le stringhe true e false, non un booleano HTML attivato dalla presenza. In aria-live="polite" con “Total: 2 items”, true conserva il contesto se cambia solo il numero. Non determina l’urgenza e non crea da solo una regione live.

Conta l’attributo esplicito più vicino nella catena degli antenati. Un false esplicito interrompe la ricerca; senza impostazione applicabile, il comportamento predefinito riguarda la parte cambiata. Alcuni ruoli hanno valori impliciti: status è atomico per impostazione predefinita.

L’esempio modifica solo lo span, mantenendo il messaggio completo. Sono stati verificati DOM e proprietà atomica nell’albero di accessibilità Chromium. Ciò non garantisce una frase precisa di ogni lettore, che può raggruppare gli aggiornamenti. Evita regioni troppo grandi che ripetono testi lunghi.

Esempi

<!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>

Risultato

atomic=true; region=Total: 3 items

Il test verifica semantica esposta e contenuto finale. La voce reale richiede una prova con il lettore scelto.

Fonti