CKTIS / JavaScript
Formulaires et validité
Utilise `input` pour réagir aux modifications d’un champ et `submit` pour traiter l’envoi d’un formulaire après la validation habituelle. `HTMLFormElement` fournit aussi des méthodes pour vérifier explicitement la validité du formulaire.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
field.addEventListener("input", handler); form.addEventListener("submit", handler); form.checkValidity(); form.reportValidity(); form.requestSubmit();HTMLFormElement est l’interface du DOM du navigateur qui représente un élément form. La propriété form.elements donne accès aux contrôles associés au formulaire. Cette interface est une API Web, pas une partie du langage ECMAScript.
Écoute l’événement input pour réagir aux modifications faites par l’utilisateur, par exemple pour actualiser une indication pendant la saisie. Affecter une valeur à field.value en JavaScript ne déclenche pas à lui seul l’événement input. L’attribut required rend un champ de texte vide invalide. form.checkValidity() renvoie le résultat sous forme de booléen. form.reportValidity() renvoie aussi un booléen et signale les erreurs de validation à l’utilisateur, sauf si l’événement invalid du contrôle concerné est annulé. L’annulation de cet événement ne change pas le résultat de la validation : la méthode renvoie false sans afficher d’erreur pour ce contrôle.
Lors d’une tentative d’envoi normale, le navigateur vérifie d’abord les contraintes. Si un champ est invalide, il bloque l’envoi et aucun événement submit n’est déclenché. Si la validation réussit, submit se déclenche sur le formulaire, et non sur le bouton. Un appel à event.preventDefault() dans le gestionnaire annule l’envoi par défaut.
Utilise form.requestSubmit() pour lancer le même processus depuis le code. Appeler directement form.submit() contourne à la fois la validation et l’événement submit. La validation dans le navigateur aide les utilisateurs à corriger leurs saisies, mais ne remplace pas la validation côté serveur.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>Form validity</title>
<form id="profile">
<label>Name <input name="displayName" required></label>
<button type="submit">Save</button>
</form>
<pre id="log"></pre>
<script>
const form = document.querySelector('#profile');
const field = form.elements.namedItem('displayName');
const log = document.querySelector('#log');
const append = (line) => { log.textContent += line + '\n'; };
field.addEventListener('input', () => {
append(`input: ${form.checkValidity()}`);
});
form.addEventListener('submit', (event) => {
event.preventDefault();
append(`submit: ${field.value}`);
});
append(`initial: ${form.checkValidity()}`);
</script>Résultat
initial: false input: true submit: A
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.