Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes