CKTIS / HTML
oninvalid: gestionar una validación fallida
El atributo oninvalid contiene código JavaScript que gestiona el evento invalid cuando un control comprobado no cumple las restricciones del formulario. No se ejecuta automáticamente con cada pulsación de tecla.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
oninvalid="JavaScript statements"oninvalid es el atributo gestor del evento invalid. Su valor es código JavaScript; dentro del controlador, event identifica el evento y this identifica el elemento. La propiedad JavaScript correspondiente, element.oninvalid, acepta una función.
El evento se dispara en un control sujeto a validación cuando una comprobación detecta que se incumple una restricción, por ejemplo, un valor vacío con required. Las comprobaciones pueden producirse al enviar el formulario o mediante checkValidity() o reportValidity(). Escribir por sí solo no dispara este evento.
invalid no se propaga: el oninvalid de un formulario no captura los eventos de sus controles. Para gestionarlos de forma común, usa addEventListener('invalid', handler, true). El evento se puede cancelar: event.preventDefault() suprime el aviso predeterminado del problema durante la validación interactiva, pero no corrige el valor ni permite enviar un formulario no válido. Con checkValidity(), la cancelación no cambia el resultado false.
En el ejemplo, el primer checkValidity() invoca el controlador y devuelve false. Después de asignar OK, la segunda comprobación devuelve true sin que se produzca otro evento.
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oninvalid example</title>
<label>Required value <input id="field" required oninvalid="document.getElementById('result').textContent += event.type + '\n'"></label>
<pre id="result"></pre>
<script>
const field = document.getElementById('field');
const result = document.getElementById('result');
const first = field.checkValidity();
result.textContent += String(first) + '\n';
field.value = 'OK';
result.textContent += String(field.checkValidity());
</script>
</html>Resultado
invalid false true
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.