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

CKTIS / HTML

aria-disabled — estado desativado de um controlo

aria-disabled informa as tecnologias de apoio de que um elemento é percetível, mas não está disponível para utilização. O atributo, por si só, não impede ações nem retira o elemento da ordem de foco; o autor tem de implementar esse comportamento.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

aria-disabled="true" | aria-disabled="false"

aria-disabled="true" identifica um elemento como desativado, mas ainda percetível. aria-disabled="false" é o valor predefinido deste estado; no entanto, não substitui o disabled nativo. Não é um atributo booleano HTML: indique explicitamente "true" ou "false", em vez de confiar apenas na presença do atributo.

Ao contrário de disabled nativo, aria-disabled, por si só, não impede a ativação, não altera a ordem de foco nem fornece um estilo de desativação. Prefira disabled nativo quando este satisfizer os requisitos. Se um botão indisponível tiver de continuar acessível com Tab, a utilização de aria-disabled também exige que a ação seja impedida por um script e que o estado seja assinalado visualmente.

O estado aplica-se ao elemento e a todos os seus descendentes que possam receber foco; por isso, não o aplique indiscriminadamente a contentores. Utilize-o apenas nos casos permitidos pelas regras HTML e pelo papel do elemento. ARIA 1.2 deprecia a sua utilização como estado global, não o atributo em si.

No exemplo, o botão nativo mantém o suporte ao teclado, mas o processador click partilhado termina antes de executar a ação. CSS apenas assinala a indisponibilidade; não a impõe.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>aria-disabled demo</title>
<style>
  button[aria-disabled="true"] { opacity: 0.6; }
</style>
<button type="button" id="save" aria-disabled="true">Save (unavailable)</button>
<p id="result">Actions: 0</p>
<script>
  const save = document.getElementById('save');
  const result = document.getElementById('result');
  let actions = 0;

  save.addEventListener('click', () => {
    if (save.getAttribute('aria-disabled') === 'true') return;
    actions += 1;
    result.textContent = `Actions: ${actions}`;
  });

  save.click();
  console.log(result.textContent);
</script>
</html>

Resultado

Actions: 0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes