Next.js App Router エキスパート
概要
Next.js App Router 開発に関するエキスパートガイド: ページ作成、動的ルーティング、ネストレイアウト、サーバー/クライアントコンポーネントの最適化、ERPロールベースのダッシュボードを網羅します。
コア機能
1. ページ作成 (/app/.../page.tsx)
ルール:
- デフォルトで サーバーコンポーネント を使用 (
'use client'ディレクティブは使用しない) fetch()または ORM クエリによる非同期データ取得を直接記述- 初期データロードに
useEffectを使用しない - ローディング状態には
Suspenseバウンダリを使用 generateMetadata()による SEO メタデータ
テンプレート:
// app/dashboard/page.tsx
import { Suspense } from 'react';
import { TaskList } from '@/components/TaskList';
import { TaskListSkeleton } from '@/components/TaskListSkeleton';
export const metadata = {
title: 'ダッシュボード',
description: 'タスク管理ダッシュボード',
};
export default async function DashboardPage() {
const tasks = await fetchTasks();
return (
<main className="p-4">
<h1>ダッシュボード</h1>
<Suspense fallback={<TaskListSkeleton />}>
<TaskList initialTasks={tasks} />
</Suspense>
</main>
);
}
2. 動的ルート ([slug]/page.tsx)
使用場面:
- 学生プロフィール:
app/students/[studentId]/page.tsx - タスク詳細:
app/tasks/[taskId]/page.tsx - コースページ:
app/courses/[courseId]/page.tsx
ルール:
paramsプロパティからパラメータを抽出 (読み取り専用)- SEO のために
generateMetadata()を使用 not-found.tsxで 404 を処理
テンプレート:
// app/students/[studentId]/page.tsx
import { notFound } from 'next/navigation';
type Params = Promise<{ studentId: string }>;
export async function generateMetadata({ params }: { params: Params }) {
const { studentId } = await params;
const student = await getStudent(studentId);
if (!student) return { title: '学生が見つかりません' };
return {
title: `${student.name} - 学生プロフィール`,
};
}
export default async function StudentProfile({ params }: { params: Params }) {
const { studentId } = await params;
const student = await getStudent(studentId);
if (!student) notFound();
return <StudentProfileView student={student} />;
}
3. パラレルルート (@フォルダ)
使用場面:
- ダッシュボードのバリエーション:
app/dashboard@(admin|teacher)/page.tsx - 分割レイアウト:
app/settings@(user|organization)/layout.tsx
テンプレート:
// app/dashboard/@admin/page.tsx - 管理者ダッシュボード
export default function AdminDashboard() {
return <AdminPanel />;
}
// app/dashboard/@teacher/page.tsx - 教師ダッシュボード
export default function TeacherDashboard() {
return <TeacherPanel />;
}
4. レイアウトとテンプレート
ルートレイアウト (app/layout.tsx):
import { Providers } from '@/components/Providers';
import './globals.css';
export const metadata = {
title: 'Todo Evolution',
description: '教育向けタスク管理',
};
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="en">
<body>
<Providers>{children}</Providers>
</body>
</html>
);
}
ネストレイアウト (app/dashboard/layout.tsx):
import { DashboardNav } from '@/components/DashboardNav';
export default function DashboardLayout({
children,
}: {
children: React.ReactNode;
}) {
return (
<div className="flex min-h-screen">
<DashboardNav />
<main className="flex-1 p-6">{children}</main>
</div>
);
}
テンプレート (app/tasks/template.tsx):
// ナビゲーション時に再実行、フォーム状態を保持
export default function TasksTemplate({ children }: { children: React.ReactNode }) {
return (
<div className="bg-gray-50 min-h-screen">
<header className="bg-white shadow">
<h1>タスク</h1>
</header>
{children}
</div>
);
}
5. サーバーコンポーネント vs クライアントコンポーネント
サーバーコンポーネントを使用する場面:
- データ取得
- データベースへの直接クエリ
- 静的コンテンツ
- サーバー限定の処理
クライアントコンポーネント ('use client') を使用する場面:
- ブラウザ API (
window,localStorage) - イベントハンドラ (
onClick,onSubmit) - React フック (
useState,useEffect) - 状態管理 (Zustand, Redux)
- インタラクティブ性
// サーバーコンポーネント (デフォルト)
export default async function TaskList() {
const tasks = await fetchTasks(); // 直接DBクエリ
return <div>{tasks.map(/* ... */)}</div>;
}
// クライアントコンポーネント
'use client';
import { useTaskStore } from '@/store/tasks';
export function TaskFilter() {
const { filter, setFilter } = useTaskStore();
return <button onClick={() => setFilter('all')}>すべてのタスク</button>;
}
6. ERP ロールベースページ
ロールガード:
// app/admin/page.tsx
import { requireRole } from '@/lib/auth';
import { redirect } from 'next/navigation';
export default async function AdminPage() {
const session = await getSession();
if (session?.role !== 'admin') {
redirect('/unauthorized');
}
return <AdminDashboard />;
}
KPI ダッシュボード (Recharts):
'use client';
import { BarChart, Bar, XAxis, YAxis, Tooltip } from 'recharts';
export function TaskKPIChart({ data }: { data: TaskStats[] }) {
return (
<BarChart width={600} height={300} data={data}>
<XAxis dataKey="date" />
<YAxis />
<Tooltip />
<Bar dataKey="completed" fill="#22c55e" />
</BarChart>
);
}
7. エラーとローディング状態
エラーバウンダリ (error.tsx):
'use client';
export default function Error({
error,
reset,
}: {
error: Error & { digest?: string };
reset: () => void;
}) {
return (
<div>
<h2>問題が発生しました!</h2>
<button onClick={reset}>再試行</button>
</div>
);
}
ローディング状態 (loading.tsx):
export default function Loading() {
return <div className="animate-pulse">読み込み中...</div>;
}
// または Suspense を使用:
export default async function Page() {
return (
<Suspense fallback={<Loading />}>
<Content />
</Suspense>
);
}
8. shadcn/ui 統合
インストール:
npx shadcn@latest add button card input dialog
サーバーコンポーネントでの使用:
import { Button } from '@/components/ui/button';
import { Card, CardContent, CardHeader } from '@/components/ui/card';
export default async function TaskPage() {
const tasks = await getTasks();
return (
<Card>
<CardHeader>タスク</CardHeader>
<CardContent>
{tasks.map(task => (
<div key={task.id}>{task.title}</div>
))}
</CardContent>
</Card>
);
}
ワークフロー決定ツリー
ユーザーリクエスト → 分析 → 実装パス
-
「ダッシュボード/管理ページを作成して」 →
page.tsxでサーバーコンポーネント → 非同期データ取得 → ナビゲーションが必要な場合はlayout.tsxを追加 -
「動的な学生プロフィールを」 →
[studentId]/page.tsxを作成 → パラメータを抽出 →generateMetadata()を追加 → 必要に応じてnot-found.tsxを作成 -
「共有レイアウトを追加して」 → 対象フォルダに
layout.tsxを作成 → 必要に応じてプロバイダーでラップ → children レンダリングを維持 -
「フォームを追加して」 →
'use client'コンポーネント → フォームデータに useState → 送信用にサーバーアクションまたはAPIルート -
「KPIチャート/分析を」 → Recharts 用に
'use client'→ データ取得用のサーバーコンポーネント親 → データをプロップとして渡す
品質チェックリスト
タスク完了前に確認:
- TypeScript の厳格モードが有効
- デフォルトでサーバーコンポーネントを使用
-
'use client'は必要な場合のみ - SEO 用の
generateMetadata() - 非同期データ用の Suspense バウンダリ
- 必要箇所にエラーバウンダリ (
error.tsx) - ハイドレーション不一致がない
- パフォーマンス最適化 (ブロックするレンダリングがない)
- モバイルファーストのレスポンシブデザイン
- アクセシブル (ARIA ラベル、キーボードナビゲーション)
共通パターン
パターン1: サーバーコンポーネント + クライアントコンポーネントの混合
// サーバーコンポーネント
export default async function Page() {
const tasks = await fetchTasks();
return <TaskList tasks={tasks} />; // インタラクティブ性のためにクライアントコンポーネント
}
'use client';
function TaskList({ tasks }: { tasks: Task[] }) {
const [filter, setFilter] = useState('all');
const filtered = tasks.filter(/* ... */);
return <div>{filtered.map(/* ... */)}</div>;
}
パターン2: 整理のためのルートグループ
app/
(marketing)/ # グループ: URL セグメントなし
about/page.tsx
contact/page.tsx
(dashboard)/ # グループ: URL セグメントなし
layout.tsx
page.tsx
パターン3: APIルート (ルートハンドラ)
// app/api/tasks/route.ts
import { NextResponse } from 'next/server';
export async function GET() {
const tasks = await db.query.tasks.findMany();
return NextResponse.json(tasks);
}
export async function POST(request: Request) {
const body = await request.json();
const task = await createTask(body);
return NextResponse.json(task, { status: 201 });
}
トリガー例
- 「ダッシュボードページを作成して」 → サーバーコンポーネントで
app/dashboard/page.tsxを生成 - 「動的な学生プロフィールルートを」 → パラメータとメタデータを持つ
app/students/[studentId]/page.tsx - 「共有レイアウトを追加して」 → children を持つ
app/dashboard/layout.tsx - 「チャート付き管理パネルを」 → サーバーコンポーネント + クライアントチャートコンポーネント
- 「ログインページを作成して」 →
'use client'フォームコンポーネント + APIルート - 「404 ページをカスタマイズして」 →
app/not-found.tsx - 「エラー処理をして」 →
app/dashboard/error.tsx
参照
高度なパターンについては references/app-router-patterns.md、ルートハンドラの例については references/api-routes.md を参照してください。