フロントエンド基礎レビュー
「コンポーネントは一つのことをうまくやるべき。もし「そして」で説明しているなら、分割せよ。」
適用タイミング
以下のコードをレビューする際にこのスキルを起動します:
- React/Vue/Svelteコンポーネント
- UIレンダリングロジック
- 状態管理コード
- CSS/スタイリングの決定
- クライアントサイドルーティング
レビューチェックリスト
コンポーネントアーキテクチャ
- 単一責任: 各コンポーネントは一つの仕事をしていますか?
- サイズチェック: コンポーネントは200行未満ですか?
- Props数: 7つ未満のpropsですか?
- 命名: 「そして」を使わずにコンポーネントを説明できますか?
状態管理
- コロケーション: 状態はそれが使われる場所にできるだけ近いですか?
- リフティング: 兄弟間で状態は親を介して適切に共有されていますか?
- Context vs Props: propドリルは回避されていますか(最大3階層)?
- サーバー状態: サーバーデータは別途管理されていますか(React Query/SWR)?
パフォーマンス
- メモ化: 高コストな計算はuseMemoでラップされていますか?
- コールバック: イベントハンドラは必要な箇所でuseCallbackでラップされていますか?
- 再レンダリング: これは不要な再レンダリングを引き起こしますか?
- 遅延読み込み: 重いコンポーネントはコード分割されていますか?
アクセシビリティ
- セマンティックHTML: 適切な要素が使われていますか(button vs div)?
- ARIA: インタラクティブな要素はアクセス可能ですか?
- キーボード: ユーザーはマウスなしで操作できますか?
よくある間違い(アンチパターン)
1. Godコンポーネント
❌ UserDashboard.tsx (1000行)
- データ取得、状態管理、UIレンダリング、ルーティング処理を全て含む
✅ 分割例:
- UserDashboardPage.tsx (コンテナ)
- UserStats.tsx (プレゼンテーション)
- UserActivity.tsx (プレゼンテーション)
- useUserData.ts (フック)
2. レンダリング内ロジック
❌ return <div>{users.filter(u => u.active).map(u => ...)}</div>
✅ const activeUsers = useMemo(() => users.filter(u => u.active), [users]);
return <div>{activeUsers.map(u => ...)}</div>
3. Propドリル
❌ <App user={user}>
<Layout user={user}>
<Main user={user}>
<Widget user={user} />
✅ const user = useUser(); // Widget.tsx内
4. ブール値Propsの乱用
❌ <Button primary secondary large small disabled loading />
✅ <Button variant="primary" size="large" state="loading" />
ソクラテス的質問
答えを直接教える代わりに、ジュニアに以下の質問を投げかけましょう:
- アーキテクチャ: 「このコンポーネントの一つの仕事は何ですか?」
- 分割: 「もしヘッダー部分だけを他の場所で使いたいと言われたら、できますか?」
- 状態: 「誰がこのデータを必要としていますか?ここに置くべきですか、それとももっと上位に置くべきですか?」
- パフォーマンス: 「親コンポーネントが再レンダリングするとどうなりますか?」
- 複雑さ: 「新しい開発者がこれを5分で理解できますか?」
標準リファレンス
詳細なパターンは以下を参照してください:
/standards/frontend/component-architecture.md
警告すべきレッドフラグ
| フラグ | 問いかける質問 |
|---|---|
| ファイル > 200行 | 「これを小さな部品に分割できますか?」 |
| useStateの呼び出しが5つ以上 | 「これらの状態の一部はリフトアップまたは結合すべきですか?」 |
| 外部の値を使っているのにuseEffectの依存配列が[] | 「依存関係が不足していませんか?」 |
| 直接のDOM操作 | 「Reactで行う方法はありませんか?」 |
| あらゆる場所でインラインスタイル | 「一貫したスタイリングアプローチを使うべきですか?」 |