Formations — 1 037 leçons en français

Accueil › React › Déclarer un état

Déclarer un état

L'état avec useStatedebutant

Une variable ordinaire ne survit pas au rendu, et la modifier ne redessine rien. useState règle les deux problèmes à la fois.

import { useState } from "react";

function Compteur() {
  const [n, setN] = useState(0);
  return <button onClick={() => setN(n + 1)}>Cliqué {n} fois</button>;
}

useState(0) rend un tableau de deux éléments : la valeur de l'état pour ce rendu, et la fonction qui la remplace. On les nomme par déstructuration, et les noms sont libres — c'est justement pourquoi React rend un tableau plutôt qu'un objet.

Appeler setN fait deux choses : React retient la nouvelle valeur, puis rappelle le composant. Le corps de la fonction s'exécute à nouveau, n vaut autre chose, et le JSX produit diffère.

L'état initial n'est lu qu'une fois

const [n, setN] = useState(0);                            // 0 au premier rendu
const [g1, setG1] = useState(construireGrille());         // appelée à chaque rendu
const [g2, setG2] = useState(construireGrille);           // appelée une seule fois

Le corps du composant est une fonction ordinaire : il s'exécute entièrement à chaque rendu. construireGrille() tourne donc chaque fois, même si React ignore son résultat après le premier rendu. Passer la fonction sans l'appeler — l'initialisation paresseuse — évite ce travail inutile.

Les deux règles

Un hook s'appelle au niveau supérieur du composant, et inconditionnellement. Pas dans un if, pas dans une boucle, pas après un return anticipé. Ce n'est pas une question de style : React identifie chaque état par l'ordre de l'appel.

Les termes à connaître

État

Une valeur qu'un composant retient d'un rendu au suivant, et dont le changement provoque un nouveau rendu. Une variable ordinaire ne fait ni l'un ni l'autre.

useState

Le hook qui déclare un état local. Il rend un tableau de deux éléments : la valeur du rendu en cours, et la fonction qui la remplace.

Déstructuration

const [a, setA] = useState(0) : la syntaxe qui nomme les deux éléments du tableau rendu. Les noms sont libres, seul l'ordre compte.

État initial

L'argument de useState. Il n'est utilisé qu'au premier rendu du composant ; aux rendus suivants React garde la valeur courante.

Initialisation paresseuse

useState(() => calcul()) : React n'appelle la fonction qu'au premier rendu. À réserver aux calculs réellement coûteux.

Règles des hooks

Un hook s'appelle au niveau supérieur d'un composant ou d'un hook personnalisé, jamais dans une condition, une boucle ou après un return anticipé.

Ordre d'appel

La façon dont React associe chaque appel de hook à son état : par position dans la suite des appels. C'est de là que viennent les règles.

Fonction de mise à jour

Le deuxième élément rendu par useState. Son identité est stable d'un rendu à l'autre : elle ne change jamais.

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.