Formations — 1 037 leçons en français

Accueil › JavaScript › Lire un formulaire

Lire un formulaire

Formulaires et stockageintermediaire

Écouter submit, pas click

formulaire.addEventListener("submit", (e) => {
  e.preventDefault();          // sans ça, la page recharge
  // traiter
});

Jamais le clic sur le bouton. La touche Entrée soumet aussi un formulaire, depuis n'importe quel champ texte — un écouteur sur le clic la manque entièrement, et le bug ne se voit pas à la souris.

Lire tous les champs d'un coup

<form id="inscription">
  <input name="email" type="email">
  <input name="age" type="number">
  <select name="pays">…</select>
</form>
formulaire.addEventListener("submit", (e) => {
  e.preventDefault();

  const donnees = Object.fromEntries(new FormData(formulaire));
  // { email: "a@b.fr", age: "30", pays: "FR" }
});

Un objet prêt à envoyer, sans un seul querySelector.

L'attribut name est obligatoire

FormData s'appuie uniquement sur name. Un champ qui n'a qu'un id est invisible pour lui, et get rend null sans la moindre erreur.

Tout est une chaîne

donnees.age          // "30", pas 30
Number(donnees.age)  // 30

Même sur un <input type="number">. La conversion est à votre charge — et on a vu que Number("") vaut 0.

Les termes à connaître

submit

L'événement déclenché à la soumission. C'est lui qu'on écoute, jamais le clic sur le bouton : la touche Entrée soumet aussi, et le clic ne la couvre pas.

FormData

Un objet qui lit tous les champs d'un formulaire d'un coup, en s'appuyant sur leur attribut name. Évite un querySelector par champ.

name

L'attribut qui donne son nom à un champ. Sans lui, le champ n'existe pas pour FormData ni pour un envoi classique — et aucune erreur ne le signale.

value

La propriété qui donne la saisie courante. Toujours une chaîne, même sur un champ de type number.

preventDefault

Annule le rechargement de page que provoque une soumission. Indispensable dès qu'on traite le formulaire en JavaScript.

reset

Vide le formulaire et restaure les valeurs initiales. formulaire.reset(), plutôt que de vider chaque champ à la main.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.