状態管理
優先度: P2 (中)
実装ガイドライン
- URL状態: 共有可能または永続的な状態には、URLを唯一の情報源として使用します。URLパラメータはリロードやリンク間で共有可能です。
useSearchParams()でアクセスし、useRouter()で更新します。パターン:const params = new URLSearchParams(searchParams); params.set('q', term); useRouter().replace(...). - サーバー状態: サーバーデータのキャッシングと取得には SWR または TanStack Query (React Query) を使用します。サーバーデータを手動で
useStateに同期しないでください。 - クライアント状態: 複雑で頻繁に変更されるUI状態には、Zustand (
create<CartState>()((set) => ({ ... }))) — 'use client' コンポーネントのみで使用 — または Jotai を使用します。低頻度のデータにはContext APIのみを利用し、プロップドリルリングを避けてください。 - 状態のリフティング: 状態はコンポーネントに可能な限り近い場所に配置します。状態が兄弟間で共有される場合にのみ親にリフトアップします。
- Next.js 15+ との統合: クライアントコンポーネントでの状態更新がサーバーサイドレンダリングロジックと競合しないようにしてください。楽観的更新は
useOptimisticフックで管理します。 - 状態のハイドレーション: クライアントコンポーネントで
localStorageから状態を初期化する際は、ハイドレーションエラーを避けるために注意してください。useEffectでラップするか、mountedフラグを使用します。
2. URL駆動の状態 (検索/フィルター)
URLパラメータを更新するには useSearchParams + useRouter を使用します。URL状態パターン を参照してください。
3. サーバー状態 (TanStack Query / SWR)
クライアントに「ライブ」データ (例: 株価のポーリング、チャット) が必要な場合、手動で useEffect フェッチを実装しないでください。ライブラリを使用してください。
// 自動キャッシング、重複排除、refreshIntervalによる再検証
const { data, error } = useSWR('/api/user', fetcher, {
refreshInterval: 30000,
});
ライブラリパターン
特定の状態管理パターンについては以下を参照してください:
アンチパターン
- 単純な状態にグローバルストアは不要:
useStateまたはURLパラメータを使用してください。基本的なUIにZustandは避けてください。 - 状態に大きなオブジェクトを置かない: 不要な再レンダリングを防ぐため、細かいプリミティブに分解してください。
- データ取得に
useEffectを使用しない: サーバー状態にはSWRまたはTanStack Queryを使用してください。 - クライアントストアにサーバー状態を入れない: RSCでデータを取得し、クライアントストアはUI専用の状態にのみ使用してください。