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

CKTIS / HTML

aria-busy — uma atualização ainda decorre

`aria-busy="true"` informa as tecnologias de apoio de que as alterações de uma região estão incompletas e podem ser apresentadas mais tarde.

Versão: WAI-ARIA 1.2

Sintaxe

<div aria-live="polite" aria-busy="true">Updating…</div>

Define a cadeia true antes de várias alterações e false no fim. A predefinição é false. Um leitor pode adiar a apresentação e tratar a atualização concluída como uma unidade. Não há garantia de um instante exato de fala.

O atributo não bloqueia cliques, desativa botões, inicia pedidos ou desenha progresso. Isso exige lógica e informação visível separadas. Não deixes a região ocupada após um erro: em código assíncrono restaura o estado em finally e apresenta a falha.

O exemplo regista false → true → false ao atualizar um contador. O botão mantém-se ativo, mostrando o limite de ARIA. Quando um widget perde temporariamente elementos próprios obrigatórios durante a reconstrução, o estado ocupado pode assinalar esse intervalo.

Exemplos

<!doctype html><meta charset="utf-8">
<div id="status" aria-live="polite" aria-busy="false"><span>0</span> items</div>
<button id="control">Available action</button><output id="result"></output>
<script>
const status = document.querySelector('#status');
const states = [status.getAttribute('aria-busy')];
status.setAttribute('aria-busy', 'true');
states.push(status.getAttribute('aria-busy'));
try {
  status.querySelector('span').textContent = '3';
} finally {
  status.setAttribute('aria-busy', 'false');
  states.push(status.getAttribute('aria-busy'));
}
document.querySelector('#result').textContent =
  states.join(' -> ') + '; region=' + status.textContent +
  '; buttonDisabled=' + document.querySelector('button').disabled;
</script>

Resultado

false -> true -> false; region=3 items; buttonDisabled=false

Verificam-se ordem dos estados, conteúdo final e ausência de desativação automática, não a fila de fala do leitor.

Fontes