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 paronChange. L'état est la source de vérité, le DOM ne fait que l'afficher.- Objet d'état
Un seul
useStatecontenant un objet{ nom, email, … }au lieu d'unuseStatepar champ. Un gestionnaire suffit alors pour tout le formulaire.- Gestionnaire générique
Un
onChangeunique qui litevent.target.namepour savoir quel champ mettre à jour. Lenamedu 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, etcheckedpour 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. Passervalue={undefined}par accident fait basculer un champ contrôlé dans ce mode, et React avertit.
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.