Formations — 1 037 leçons en français

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 un onChange qui 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 value ne 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 value sans onChange.

checked

L'équivalent de value pour une case à cocher ou un bouton radio. Un checked contrôlé se double aussi d'un onChange.

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.