Formations — 1 037 leçons en français

Accueil › React › Composants composés

Composants composés

Patterns de compositionavance

Le symptôme

<Dialogue
  titre="Supprimer le client"
  avecEntete
  avecCroix
  texteConfirmer="Supprimer"
  variante="danger"
  sansPiedDePage={false}
  largeur="md"
/>

Huit props, dont cinq ne servent qu'à décider ce qui s'affiche. Rien ne dit que avecCroix sans avecEntete est invalide. Chaque nouveau besoin ajoute une option, et le nombre de combinaisons double à chaque fois.

La forme composée

<Dialogue>
  <Dialogue.Entete>
    Supprimer le client
    <Dialogue.Croix />
  </Dialogue.Entete>
  <Dialogue.Corps>Cette action est définitive.</Dialogue.Corps>
  <Dialogue.PiedDePage>
    <Dialogue.Fermer>Annuler</Dialogue.Fermer>
    <Bouton variante="danger">Supprimer</Bouton>
  </Dialogue.PiedDePage>
</Dialogue>

Les cinq booléens ont disparu. Ce qui est affiché est ce qui est écrit, et l'ordre comme le contenu appartiennent à l'appelant.

Ce qui fait tenir l'ensemble

const CtxDialogue = createContext(null);

function useDialogue() {
  const ctx = useContext(CtxDialogue);
  if (!ctx) throw new Error("Ce composant doit être utilisé dans <Dialogue>");
  return ctx;
}

Le parent tient l'état — ouvert, fermé, élément focalisé — et le publie par contexte. Les enfants le lisent. Aucune prop ne circule entre eux, donc leur ordre et leur profondeur sont libres.

Le prix est l'inverse : l'API devient invisible. Rien dans la signature de <Dialogue> ne dit quels enfants existent, ni lesquels sont obligatoires. Le hook de garde est ce qui rend cette dette supportable.

Les termes à connaître

Composant composé

Un composant éclaté en plusieurs sous-composants qui se montent ensemble — <Onglets>, <Onglets.Liste>, <Onglets.Panneau>. L'état est tenu par le parent, les enfants le lisent par contexte.

Slot

Un emplacement que l'appelant remplit avec le JSX de son choix. Un slot remplace une prop de configuration par du balisage.

Contexte implicite

Le canal par lequel le parent transmet son état aux enfants sans passer de props. C'est ce qui permet d'écrire les enfants dans n'importe quel ordre, et aussi ce qui rend l'API invisible.

Explosion de props

Le symptôme qui déclenche ce pattern : un composant dont les options booléennes se multiplient — avecEntete, sansBordure, titreCentre — jusqu'à ce que personne ne sache quelles combinaisons sont valides.

Objet composé

L'habitude d'attacher les sous-composants au parent (Onglets.Panneau = Panneau). Cela groupe l'API et documente la parenté, au prix d'un objet qui gêne l'analyse statique des exports.

Enfant orphelin

Un sous-composant rendu hors de son parent. Sans garde, il lit un contexte absent et échoue plus loin avec un message incompréhensible.

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.