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.