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

CKTIS / HTML

aria-invalid — comunicar um valor inválido

`aria-invalid` comunica o estado de erro de um controlo, mas não valida nem impede o envio do formulário.

Versão: WAI-ARIA 1.2

Sintaxe

<input aria-invalid="true" aria-describedby="error">

Os valores são false, true, grammar e spelling. Por predefinição não é sinalizado erro. Escolhe o estado com base numa verificação real, normalmente após interação ou tentativa de envio; não marques desnecessariamente como inválido um formulário vazio ainda não utilizado.

Mostra uma explicação útil e associa-a ao campo. Alterar ARIA não substitui restrições HTML nem verificações no servidor. Quando o valor for corrigido, remove o erro desatualizado e atualiza o estado em conformidade.

O exemplo deteta algarismos num nome que exige letras e apresenta uma explicação. A árvore de acessibilidade recebe o estado inválido, mas checkValidity() continua a devolver verdadeiro porque não se definiu nenhuma restrição nativa. Isto demonstra intencionalmente o limite, não uma validação completa do formulário.

Exemplos

<!doctype html><meta charset="utf-8">
<label for="name">Project name</label><input id="name" value="123" aria-describedby="error">
<p id="error" hidden>Use letters only.</p><output id="result"></output>
<script>
const input = document.querySelector('#name');
const invalid = !/^[A-Za-z]+$/.test(input.value);
input.setAttribute('aria-invalid', String(invalid));
document.querySelector('#error').hidden = !invalid;
document.querySelector('#result').textContent = 'marked=' + invalid + '; nativeValid=' + input.checkValidity();
</script>

Resultado

marked=true; nativeValid=true

O teste verifica a explicação visível e o erro semântico, distinguindo-os da validade nativa do campo.

Fontes