CKTIS / HTML
aria-atomic — apresentar toda a mensagem alterada
`aria-atomic` define se uma atualização de região live deve ser apresentada por inteiro ou apenas pela parte alterada.
Versão: WAI-ARIA 1.2
Sintaxe
<div aria-live="polite" aria-atomic="true">Total: <span>2</span></div>ARIA usa as cadeias true e false, não um booleano HTML ativado pela presença. Numa região aria-live="polite" com “Total: 2 items”, true mantém o contexto quando só muda o número. Não determina urgência nem cria sozinho uma região live.
Conta o atributo explícito mais próximo na cadeia de ascendentes. Um false explícito interrompe a procura; sem definição aplicável, a parte alterada é o comportamento predefinido. Alguns papéis têm valores implícitos: status é atómico por predefinição.
O exemplo altera apenas o span, preservando a mensagem. Foram verificados DOM e propriedade atómica na árvore de acessibilidade do Chromium. Isso não garante uma frase de todos os leitores, que podem agrupar alterações. Evita regiões grandes que repitam textos extensos.
Exemplos
<!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>Resultado
atomic=true; region=Total: 3 items
O teste verifica semântica exposta e conteúdo final. A fala real exige ensaio com o leitor escolhido.