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.
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.