Accueil › React › Le champ contrôlé
Le champ contrôlé
Événements et champs contrôlésdebutant
Un champ contrôlé affiche ce que l'état contient, et prévient l'état quand l'utilisateur tape.
function ChampNom() {
const [nom, setNom] = useState("");
return (
<input
value={nom}
onChange={(e) => setNom(e.target.value)}
placeholder="Votre nom"
/>
);
}
Deux props, et un cycle : la frappe déclenche onChange, onChange met l'état
à jour, le nouvel état redonne sa value au champ. L'état est la source de
vérité ; le champ n'en est que le reflet.
La conséquence pratique : pour vider le champ, on écrit setNom(""). On ne
touche jamais au nœud du DOM.
value sans onChange
<input value={nom} /> {/* ❌ champ figé */}
<input value={nom} readOnly /> {/* ✅ figé volontairement */}
Sans onChange, React réaffiche la valeur de l'état après chaque frappe : le
champ ne bouge pas. React avertit en console et suggère defaultValue ou
readOnly.
Le champ non contrôlé
<form onSubmit={(e) => {
e.preventDefault();
envoyer(e.currentTarget.nom.value);
}}>
<input name="nom" defaultValue="Anne" />
</form>
Ici le DOM garde la valeur. defaultValue ne sert qu'à l'initialiser. C'est
plus léger — aucun rendu par frappe — mais rien ne peut réagir pendant la
saisie.
Les termes à connaître
- Champ contrôlé
Un champ dont la valeur affichée vient de l'état React :
value={etat}plus unonChangequi met l'état à jour. L'état est la source de vérité, le champ n'en est que le reflet.- Champ non contrôlé
Un champ dont le DOM garde la valeur. On fournit éventuellement une valeur initiale avec
defaultValue, puis on lit le champ au moment de la soumission.- Source de vérité
L'unique endroit où une information existe vraiment. Tout le reste en est une copie, qu'on ne modifie pas directement.
- defaultValue
La prop React pour la valeur initiale d'un champ non contrôlé. L'attribut HTML
valuene joue pas ce rôle en React.- readOnly
La prop qui déclare volontairement un champ non modifiable. C'est la façon correcte d'avoir
valuesansonChange.- checked
L'équivalent de
valuepour une case à cocher ou un bouton radio. Uncheckedcontrôlé se double aussi d'unonChange.
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.