Formations — 1 037 leçons en français

Accueil › React › useReducer

useReducer

Gestion d'étatintermediaire

Deux hooks pour le même travail

// useState : l'appelant décide de la nouvelle valeur
const [quantite, setQuantite] = useState(1);
setQuantite(quantite + 1);

// useReducer : l'appelant décrit l'événement, le réducteur décide
const [etat, envoyer] = useReducer(reducteur, { quantite: 1 });
envoyer({ type: "incrementer" });

useReducer ne rend rien possible que useState interdise. Il déplace la décision : la règle de changement quitte le gestionnaire d'événement pour rejoindre une fonction unique, écrite en dehors du composant.

Le réducteur

function reducteur(etat, action) {
  switch (action.type) {
    case "incrementer":
      return { ...etat, quantite: etat.quantite + 1 };
    case "decrementer":
      return { ...etat, quantite: Math.max(1, etat.quantite - 1) };
    case "saisir":
      return { ...etat, quantite: action.valeur };
    default:
      return etat;
  }
}

function Ligne() {
  const [etat, envoyer] = useReducer(reducteur, { quantite: 1 });
  return (
    <>
      <button onClick={() => envoyer({ type: "decrementer" })}>moins</button>
      <span>{etat.quantite}</span>
      <button onClick={() => envoyer({ type: "incrementer" })}>plus</button>
    </>
  );
}

La règle « on ne descend pas sous 1 » est écrite une seule fois. Avec trois appels à setQuantite dispersés dans le composant, elle serait écrite trois fois — ou deux fois et oubliée une.

Ce que l'envoi ne fait pas

envoyer ne modifie pas la variable d'état du rendu en cours. Il planifie un rendu. Lire etat juste après un envoi donne l'ancienne valeur : c'est la même règle que pour useState, et c'est la question d'entretien la plus fréquente sur les deux hooks.

En échange, envoyer a une identité stable. On peut le passer à un composant enfant mémoïsé, ou l'omettre des dépendances d'un effet, sans rien casser.

Les termes à connaître

useReducer

Un hook d'état qui remplace « comment changer la valeur » par « quel événement vient de se produire ». Il renvoie [etat, envoyer].

Réducteur

La fonction (etat, action) => nouvelEtat qui décide du prochain état. Elle vit en dehors du composant et ne connaît ni le DOM ni le réseau.

Action

Un objet décrivant ce qui s'est passé, par convention avec un champ type. C'est une donnée, pas un appel de fonction.

dispatch (envoyer)

La fonction qui transmet une action au réducteur. Son identité est stable pour la durée de vie du composant : elle n'a pas à figurer dans les dépendances d'un effet.

Initialiseur

Troisième argument facultatif de useReducer. React l'appelle avec le deuxième argument pour fabriquer l'état initial, et seulement au premier rendu.

Abandon de rendu

Quand le réducteur renvoie l'état reçu à l'identique, React peut renoncer à refaire le rendu des enfants.

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.