Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

aria-invalid — comunicar un valor incorrecto

`aria-invalid` comunica el estado de error de un control, pero no valida ni impide enviar el formulario.

Versión: WAI-ARIA 1.2

Sintaxis

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

Los valores son false, true, grammar y spelling. Por defecto no se señala ningún error. Elige el estado mediante una comprobación real, normalmente tras interactuar o intentar enviar; no marques innecesariamente como inválido un formulario vacío que aún no se ha usado.

Muestra una explicación útil y asóciala al campo. Cambiar ARIA no sustituye las restricciones HTML ni las comprobaciones del servidor. Cuando se corrija el valor, elimina el error desactualizado y modifica el estado según corresponda.

El ejemplo detecta cifras en un nombre que requiere letras y muestra una explicación. El árbol de accesibilidad recibe el estado inválido, pero checkValidity() sigue devolviendo verdadero porque no se ha configurado ninguna restricción nativa. Se demuestra intencionadamente ese límite, no una validación completa del formulario.

Ejemplos

<!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

La prueba comprueba una explicación visible y un error semántico, distinguiéndolos de la validez nativa del campo.

Fuentes