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.