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

CKTIS / HTML

aria-live — anunciar alterações de conteúdo

`aria-live` indica com que urgência as tecnologias de apoio devem apresentar alterações de uma região.

Versão: WAI-ARIA 1.2

Sintaxe

<p aria-live="polite"></p>

Usa polite para atualizações comuns, assertive com moderação para mensagens urgentes e off para suprimir anúncios habituais em segundo plano. O último valor não garante silêncio quando o foco está dentro da região.

Prepara a região antes de atualizar o seu conteúdo. Não desloques desnecessariamente o foco para uma mensagem. A urgência é uma orientação para as tecnologias de apoio, não uma garantia da ordem ou do momento da fala; o âmbito do anúncio e o agrupamento das alterações são questões separadas.

O exemplo atualiza uma região existente após ativar Save. O teste confirma Settings saved. e a semântica live na árvore de acessibilidade. Não simula um leitor específico, pelo que não promete um anúncio idêntico em todas as configurações.

Exemplos

<!doctype html><meta charset="utf-8">
<button id="save">Save</button><p id="status" aria-live="polite"></p>
<output id="result"></output>
<script>
document.querySelector('#save').addEventListener('click', () => { document.querySelector('#status').textContent = 'Settings saved.'; });
document.querySelector('#save').click();
document.querySelector('#result').textContent = 'message=' + document.querySelector('#status').textContent;
</script>

Resultado

message=Settings saved.

Verificaram-se o conteúdo alterado e a semântica da região. A ordem real da fala exige um teste separado com um leitor de ecrã.

Fontes