Modèles de composition React
Modèles de composition pour construire des composants React flexibles et maintenables. Évitez la prolifération de props booléennes en utilisant des composants composés, le lift d'état et la composition interne. Ces modèles rendent les codebases plus faciles à travailler, tant pour les humains que pour les agents IA, à mesure qu'ils évoluent.
Quand appliquer
Référez-vous à ces directives lorsque :
- Vous refactorisez des composants avec de nombreuses props booléennes
- Vous construisez des bibliothèques de composants réutilisables
- Vous concevez des API de composants flexibles
- Vous révisez une architecture de composants
- Vous travaillez avec des composants composés ou des fournisseurs de contexte
Catégories de règles par priorité
| Priorité | Catégorie | Impact | Préfixe |
|---|---|---|---|
| 1 | Architecture des composants | ÉLEVÉ | architecture- |
| 2 | Gestion d'état | MOYEN | state- |
| 3 | Modèles d'implémentation | MOYEN | patterns- |
| 4 | API React 19 | MOYEN | react19- |
Référence rapide
1. Architecture des composants (ÉLEVÉ)
architecture-avoid-boolean-props- N'ajoutez pas de props booléennes pour personnaliser le comportement ; utilisez la composition.architecture-compound-components- Structurez les composants complexes avec un contexte partagé.
2. Gestion d'état (MOYEN)
state-decouple-implementation- Le fournisseur (Provider) est le seul endroit qui sait comment l'état est géré.state-context-interface- Définissez une interface générique avec état, actions, méta pour l'injection de dépendances.state-lift-state- Déplacez l'état dans les composants fournisseurs pour l'accès entre composants frères.
3. Modèles d'implémentation (MOYEN)
patterns-explicit-variants- Créez des composants de variante explicites plutôt que des modes booléens.patterns-children-over-render-props- Utilisezchildrenpour la composition plutôt que les propsrenderX.
4. API React 19 (MOYEN)
⚠️ React 19+ uniquement. Ignorez cette section si vous utilisez React 18 ou une version antérieure.
react19-no-forwardref- N'utilisez pasforwardRef; utilisezuse()au lieu deuseContext().
Comment utiliser
Lisez les fichiers de règles individuels pour des explications détaillées et des exemples de code :
rules/architecture-avoid-boolean-props.md
rules/state-context-interface.md
Chaque fichier de règle contient :
- Une brève explication de son importance
- Un exemple de code incorrect avec explication
- Un exemple de code correct avec explication
- Contexte supplémentaire et références
Document complet compilé
Pour le guide complet avec toutes les règles développées : AGENTS.md