Formations — 1 037 leçons en français

Accueil › React › Un formulaire à plusieurs champs

Un formulaire à plusieurs champs

Les formulairesdebutant

Un formulaire de dix champs ne demande pas dix useState. Il demande un objet et un gestionnaire.

const VIDE = { nom: "", email: "", quantite: 1, cgv: false };

function Inscription() {
  const [valeurs, setValeurs] = useState(VIDE);

  function changer(e) {
    const { name, type, checked, value } = e.target;
    setValeurs((v) => ({ ...v, [name]: type === "checkbox" ? checked : value }));
  }

  return (
    <form>
      <input name="nom" value={valeurs.nom} onChange={changer} />
      <input name="email" value={valeurs.email} onChange={changer} />
      <input name="quantite" type="number" value={valeurs.quantite} onChange={changer} />
      <input name="cgv" type="checkbox" checked={valeurs.cgv} onChange={changer} />
    </form>
  );
}

Deux choses font tout fonctionner. L'attribut name du champ est la clé de l'objet d'état, et la notation [name]: crée la propriété correspondante.

Trois détails qui mordent

value est toujours une chaîne. Même avec type="number", même avec type="date". Un quantite + 1 donnera "11".

Une case à cocher n'utilise pas value. Elle utilise checked, et son value vaut "on" quelle que soit sa position.

La remise à zéro est une ligne, puisque l'état vide est déjà écrit :

<button type="button" onClick={() => setValeurs(VIDE)}>Effacer</button>

VIDE est déclaré hors du composant : il n'est pas recréé à chaque rendu, et l'état de départ est lisible en une ligne.

Les termes à connaître

Champ contrôlé

Un champ dont la valeur affichée vient de l'état React (value) et dont chaque frappe passe par onChange. L'état est la source de vérité, le DOM ne fait que l'afficher.

Objet d'état

Un seul useState contenant un objet { nom, email, … } au lieu d'un useState par champ. Un gestionnaire suffit alors pour tout le formulaire.

Gestionnaire générique

Un onChange unique qui lit event.target.name pour savoir quel champ mettre à jour. Le name du champ devient la clé de l'objet d'état.

`event.target`

L'élément qui a déclenché l'événement. On y lit name, value, type, et checked pour une case à cocher.

Clé dynamique

La notation { [name]: valeur } qui crée une propriété dont le nom est calculé à l'exécution. C'est elle qui rend le gestionnaire générique possible.

Champ non contrôlé

Un champ sans value, dont le DOM garde la valeur. Passer value={undefined} par accident fait basculer un champ contrôlé dans ce mode, et React avertit.

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.