React-Compositionsmuster
Kompositionsmuster für flexible, wartbare React-Komponenten. Vermeiden Sie die Explosion boolescher Props durch zusammengesetzte Komponenten, Heben von Zuständen und interne Komposition. Diese Muster erleichtern sowohl Menschen als auch KI-Agenten die Arbeit mit Codebasen, wenn diese skalieren.
Wann anwenden
Diese Richtlinien verwenden bei:
- Refaktorierung von Komponenten mit vielen booleschen Props
- Erstellung wiederverwendbarer Komponentenbibliotheken
- Entwurf flexibler Komponenten-APIs
- Überprüfung der Komponentenarchitektur
- Arbeit mit zusammengesetzten Komponenten oder Context-Providern
Regelkategorien nach Priorität
| Priorität | Kategorie | Einfluss | Präfix |
|---|---|---|---|
| 1 | Komponentenarchitektur | HOCH | architecture- |
| 2 | Zustandsverwaltung | MITTEL | state- |
| 3 | Implementierungsmuster | MITTEL | patterns- |
| 4 | React-19-APIs | MITTEL | react19- |
Kurzreferenz
1. Komponentenarchitektur (HOCH)
architecture-avoid-boolean-props– Fügen Sie keine booleschen Props zur Verhaltensanpassung hinzu; verwenden Sie Komposition.architecture-compound-components– Strukturieren Sie komplexe Komponenten mit gemeinsam genutztem Kontext.
2. Zustandsverwaltung (MITTEL)
state-decouple-implementation– Der Provider ist der einzige Ort, der weiß, wie der Zustand verwaltet wird.state-context-interface– Definieren Sie eine generische Schnittstelle mit Zustand, Aktionen und Metadaten für die Abhängigkeitsinjektion.state-lift-state– Verschieben Sie Zustände in Provider-Komponenten für den Zugriff durch Geschwisterkomponenten.
3. Implementierungsmuster (MITTEL)
patterns-explicit-variants– Erstellen Sie explizite Variantenkomponenten anstelle von booleschen Modi.patterns-children-over-render-props– Verwenden Siechildrenfür die Komposition anstelle vonrenderX-Props.
4. React-19-APIs (MITTEL)
⚠️ Nur React 19+. Überspringen Sie diesen Abschnitt bei Verwendung von React 18 oder älter.
react19-no-forwardref– Verwenden Sie nichtforwardRef; verwenden Sieuse()anstelle vonuseContext().
Verwendung
Lesen Sie die einzelnen Regeldateien für detaillierte Erklärungen und Codebeispiele:
rules/architecture-avoid-boolean-props.md
rules/state-context-interface.md
Jede Regeldatei enthält:
- Kurze Erklärung, warum sie wichtig ist
- Falsches Codebeispiel mit Erklärung
- Korrektes Codebeispiel mit Erklärung
- Zusätzlicher Kontext und Referenzen
Vollständiges kompiliertes Dokument
Für die vollständige Anleitung mit allen erweiterten Regeln: AGENTS.md