CKTIS / JavaScript
Événements `submit` et `input` des formulaires HTML
Utilisez `input` pour réagir aux modifications et `submit` pour gérer l’envoi du formulaire au bon moment dans le processus de validation.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
form.addEventListener("submit", onSubmit);
form.addEventListener("input", onInput);
form.requestSubmit();
form.requestSubmit(submitter);
form.submit();input se déclenche sur le champ modifié et remonte dans l’arbre DOM. Dans un écouteur installé sur le formulaire, event.target désigne le champ et event.currentTarget désigne le formulaire pendant l’exécution de l’écouteur. Un champ situé hors du formulaire et associé par l’attribut form ne lui transmet pas son événement par cette seule association. Utilisez input pour réagir pendant la saisie ; change signale une modification confirmée, généralement à la perte du focus pour un champ texte. Affecter une valeur à .value ne déclenche pas input à lui seul.
submit se déclenche sur le formulaire, pas sur le bouton. C’est un SubmitEvent qui remonte dans le DOM et peut être annulé. Écoutez-le plutôt que le click du bouton pour gérer aussi l’envoi implicite, par exemple avec Entrée lorsque le navigateur le permet. event.submitter désigne le bouton de soumission, ou vaut null si aucun bouton n’a déclenché l’envoi. Pour empêcher l’envoi par défaut, appelez event.preventDefault() dans l’écouteur avant tout await.
form.requestSubmit() suit les règles normales d’envoi sans sélectionner de bouton. form.requestSubmit(button) utilise ce bouton et tient compte de ses réglages, notamment formaction et formnovalidate. Si la validation des contraintes n’est pas ignorée et échoue, invalid se déclenche sur les champs non valides, et submit ne se déclenche pas. Un élément qui n’est pas un bouton de soumission provoque une TypeError ; un bouton de soumission qui n’appartient pas à ce formulaire provoque une NotFoundError.
L’appel direct à form.submit() ignore la validation des contraintes et ne déclenche pas submit. Un champ dont le name ou l’id vaut submit peut masquer la méthode. La validation dans le navigateur ne remplace pas celle côté serveur. Ces API appartiennent à la plateforme web, pas à ECMAScript 2024 ; vérifiez leur prise en charge dans l’environnement cible.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Form submit and input events</title>
</head>
<body>
<script>
(() => {
const form = document.createElement("form");
const field = document.createElement("input");
field.type = "text";
field.required = true;
const button = document.createElement("button");
button.type = "submit";
button.value = "save";
button.textContent = "Save";
form.append(field, button);
field.addEventListener("invalid", (event) => {
event.preventDefault();
console.log("invalid");
});
form.addEventListener("input", (event) => {
if (event.target === field) console.log(`input: ${field.value}`);
});
form.addEventListener("submit", (event) => {
event.preventDefault();
console.log(`submit: ${event.submitter.value}`);
});
document.body.append(form);
try {
form.requestSubmit(button);
field.value = "Ada";
console.log(`set: ${field.value}`);
field.dispatchEvent(new Event("input", { bubbles: true }));
form.requestSubmit(button);
} finally {
form.remove();
}
})();
</script>
</body>
</html>Résultat
invalid set: Ada input: Ada submit: save
Enregistrez l’exemple dans un fichier HTML et ouvrez-le dans un navigateur. Ouvrez la console et rechargez la page. La première demande affiche `invalid`. Après `set: Ada`, seul l’événement envoyé manuellement produit `input: Ada` ; la seconde demande affiche `submit: save`, mais l’écouteur annule l’envoi.
Leçons associées
- JavaScript · Leçon 15 · Avancé · Version : 4
Sources
- HTML Standard — Form submission algorithm
- HTML Standard — Constraints: Security
- HTMLFormElement: submit event
- Element: input event
- HTMLElement: change event
- HTMLFormElement: requestSubmit() method
- HTMLFormElement: submit() method
- Event: currentTarget property
- Event: preventDefault() method
- EventTarget: dispatchEvent() method