Formations — 1 037 leçons en français

Accueil › React › Créer et consommer un contexte

Créer et consommer un contexte

Le contexteintermediaire

Un contexte transporte une valeur d'un composant vers tous ses descendants, sans la passer de main en main par les props. Trois étapes.

1. Créer

import { createContext } from "react";

export const Theme = createContext("clair");

L'argument est la valeur par défaut. Elle ne sert que si aucun fournisseur n'existe au-dessus du lecteur.

2. Fournir

function App() {
  const [theme, setTheme] = useState("clair");

  return (
    <Theme value={theme}>
      <TableauDeBord />
    </Theme>
  );
}

En React 19, l'objet contexte s'utilise directement comme composant. L'ancienne écriture <Theme.Provider value={theme}> fonctionne toujours, mais elle est dépréciée.

3. Consommer

function Bouton() {
  const theme = useContext(Theme);
  return <button className={theme}>Valider</button>;
}

useContext remonte l'arbre de rendu et s'arrête au premier fournisseur rencontré. Aucun composant intermédiaire n'a besoin de connaître theme : c'est tout l'intérêt.

Ce que le contexte ne fait pas

Il ne stocke rien. L'état vit toujours dans un useState ou un useReducer quelque part ; le contexte ne fait que le distribuer. Et il ne descend que dans ce que le fournisseur rend : un composant rendu ailleurs, même importé dans le même fichier, ne voit rien.

Les termes à connaître

createContext

Crée un objet contexte. Son unique argument est la valeur par défaut, utilisée seulement quand aucun fournisseur ne se trouve au-dessus du consommateur.

Fournisseur

Le composant contexte lui-même, avec une prop value. En React 19 on écrit <Theme value={t}> ; avant, il fallait <Theme.Provider value={t}>.

useContext

Le hook qui lit la valeur du fournisseur le plus proche au-dessus, dans l'arbre de rendu. Comme tout hook, il s'appelle au premier niveau du composant.

use

Depuis React 19, use(MonContexte) lit un contexte et accepte d'être appelé dans une condition ou une boucle, ce que useContext interdit.

Valeur par défaut

Le filet de sécurité d'un contexte sans fournisseur. Elle ne sert jamais quand un fournisseur existe, même si sa value vaut undefined.

Arbre de rendu

La hiérarchie des composants réellement rendus, pas celle des fichiers. Un contexte ne descend que dans ce que le fournisseur rend.

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.