CKTIS / HTML
aria-atomic — présenter tout le message modifié
`aria-atomic` précise si une mise à jour de région live doit être présentée entièrement ou uniquement par sa partie modifiée.
Version : WAI-ARIA 1.2
Syntaxe
<div aria-live="polite" aria-atomic="true">Total: <span>2</span></div>ARIA emploie les chaînes true et false, et non un booléen HTML activé par présence. Dans une région aria-live="polite" contenant « Total: 2 items », true conserve le contexte lorsque seul le nombre change. Il ne règle pas l’urgence et ne crée pas seul une région live.
L’attribut explicite le plus proche dans la chaîne des ancêtres compte. Un false explicite arrête cette recherche ; sans réglage applicable, seule la partie modifiée est le comportement par défaut. Certains rôles fournissent des valeurs implicites : status est atomique par défaut.
L’exemple modifie seulement le span et conserve le message complet. Le DOM et la propriété atomique de l’arbre d’accessibilité Chromium ont été vérifiés. Cela ne garantit pas une phrase précise de chaque lecteur, qui peut regrouper les mises à jour. Évitez les régions trop grandes répétant un long texte.
Exemples
<!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>Résultat
atomic=true; region=Total: 3 items
Le test vérifie la sémantique exposée et le contenu final ; la parole réelle exige un essai avec le lecteur choisi.