React Composition Patterns (React合成パターン) は何をしますか?
柔軟で保守性の高いReactコンポーネントを構築するための合成パターン。 ブーリアンプロップの乱用を避けるために、コンパウンドコンポーネント、状態のリフトアップ、内部の合成を活用します。 これらのパターンにより、コードベースは規模が拡大しても、人間とAIエージェントの両方が扱いやすくなります。
適用タイミング
以下の状況でこれらのガイドラインを参照してください:
- 多数のブーリアンプロップを持つコンポーネントのリファクタリング
- 再利用可能なコンポーネントライブラリの構築
- 柔軟なコンポーネントAPIの設計
- コンポーネントアーキテクチャのレビュー
- コンパウンドコンポーネントやコンテキストプロバイダーの使用
優先度別ルールカテゴリ
| 優先度 | カテゴリ | 影響 | プレフィックス |
|---|---|---|---|
| 1 | コンポーネントアーキテクチャ | HIGH | architecture- |
| 2 | 状態管理 | MEDIUM | state- |
| 3 | 実装パターン | MEDIUM | patterns- |
| 4 | React 19 API | MEDIUM | react19- |
クイックリファレンス
1. コンポーネントアーキテクチャ (HIGH)
architecture-avoid-boolean-props- 動作をカスタマイズするためにブーリアンプロップを追加しないでください。代わりに合成を使用します。architecture-compound-components- 共有コンテキストを持つ複雑なコンポーネントを構造化します。
2. 状態管理 (MEDIUM)
state-decouple-implementation- Providerだけが状態がどのように管理されているかを知っています。state-context-interface- 依存性注入のために、state、actions、metaを含むジェネリックインターフェースを定義します。state-lift-state- 兄弟コンポーネントからアクセスできるように、状態をProviderコンポーネントに移動します。
3. 実装パターン (MEDIUM)
patterns-explicit-variants- ブーリアンモードの代わりに、明示的なバリアントコンポーネントを作成します。patterns-children-over-render-props- renderXプロップの代わりにchildrenを使用して合成を行います。
4. React 19 API (MEDIUM)
⚠️ React 19+ のみ対象。 React 18以前を使用している場合はこのセクションをスキップしてください。
react19-no-forwardref-forwardRefを使用しないでください。useContext()の代わりにuse()を使用します。
使用方法
詳細な説明とコード例については、個別のルールファイルを参照してください:
rules/architecture-avoid-boolean-props.md
rules/state-context-interface.md
各ルールファイルには以下が含まれています:
- なぜそれが重要なのかの簡単な説明
- 説明付きの誤ったコード例
- 説明付きの正しいコード例
- 追加のコンテキストと参考情報
完全なコンパイル済みドキュメント
すべてのルールを展開した完全なガイドについては: AGENTS.md