CKTIS / HTML
oninvalid — gérer l’échec de la validation
L’attribut oninvalid contient du code JavaScript qui gère l’événement invalid lorsqu’un contrôle vérifié ne respecte pas les contraintes du formulaire. Il ne s’exécute pas automatiquement à chaque frappe.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
oninvalid="JavaScript statements"oninvalid est l’attribut de gestion de l’événement invalid. Sa valeur est du code JavaScript ; dans le gestionnaire, event désigne l’événement et this l’élément. La propriété JavaScript correspondante, element.oninvalid, accepte une fonction.
L’événement se déclenche sur un contrôle soumis à la validation lorsqu’une vérification détecte une violation de contrainte, par exemple une valeur vide avec required. Les vérifications peuvent avoir lieu lors de l’envoi du formulaire ou avec checkValidity() ou reportValidity(). La saisie seule ne déclenche pas cet événement.
invalid ne remonte pas dans l’arborescence : le oninvalid d’un formulaire ne capte pas les événements de ses contrôles. Pour une gestion commune, utilisez addEventListener('invalid', handler, true). L’événement peut être annulé : event.preventDefault() supprime le signalement par défaut du problème pendant la validation interactive, mais ne corrige pas la valeur et ne permet pas d’envoyer un formulaire invalide. Avec checkValidity(), l’annulation ne change pas le résultat false.
Dans l’exemple, le premier checkValidity() appelle le gestionnaire et renvoie false. Après l’attribution de OK, la seconde vérification renvoie true sans nouvel événement.
Exemples
<!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>Résultat
invalid false true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.