Was macht Next.js App Router Experte?
Überblick
Expertenwissen für die Entwicklung mit dem Next.js App Router, einschließlich Seitenerstellung, dynamischem Routing, verschachtelten Layouts, Optimierung von Server/Client-Komponenten und ERP-Rollen-basierten Dashboards.
Kernfunktionen
1. Seitenerstellung (/app/.../page.tsx)
Regeln:
- Standardmäßig Server-Komponenten verwenden (keine 'use client'-Direktive)
- Asynchroner Datenabruf mit
fetch()oder ORM-Abfragen direkt - Kein
useEffectfür initialen Datenabruf Suspense-Grenzen für Ladezustände verwenden- SEO-Metadaten via
generateMetadata()
Vorlage:
// app/dashboard/page.tsx
import { Suspense } from 'react';
import { TaskList } from '@/components/TaskList';
import { TaskListSkeleton } from '@/components/TaskListSkeleton';
export const metadata = {
title: 'Dashboard',
description: 'Ihr Aufgabenverwaltungs-Dashboard',
};
export default async function DashboardPage() {
const tasks = await fetchTasks();
return (
<main className="p-4">
<h1>Dashboard</h1>
<Suspense fallback={<TaskListSkeleton />}>
<TaskList initialTasks={tasks} />
</Suspense>
</main>
);
}
2. Dynamische Routen ([slug]/page.tsx)
Verwendungszwecke:
- Studentenprofile:
app/students/[studentId]/page.tsx - Aufgabendetails:
app/tasks/[taskId]/page.tsx - Kursseiten:
app/courses/[courseId]/page.tsx
Regeln:
- Parameter aus der
params-Eigenschaft extrahieren (schreibgeschützt) generateMetadata()für SEO verwenden- 404-Fehler mit
not-found.tsxbehandeln
Vorlage:
// 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: 'Student nicht gefunden' };
return {
title: `${student.name} - Studentenprofil`,
};
}
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. Parallele Routen (@folder)
Verwendungszwecke:
- Dashboard-Varianten:
app/dashboard@(admin|teacher)/page.tsx - Geteilte Layouts:
app/settings@(user|organization)/layout.tsx
Vorlage:
// app/dashboard/@admin/page.tsx - Admin-Dashboard
export default function AdminDashboard() {
return <AdminPanel />;
}
// app/dashboard/@teacher/page.tsx - Lehrer-Dashboard
export default function TeacherDashboard() {
return <TeacherPanel />;
}
4. Layouts & Templates
Root-Layout (app/layout.tsx):
import { Providers } from '@/components/Providers';
import './globals.css';
export const metadata = {
title: 'Todo Evolution',
description: 'Aufgabenverwaltung für die Bildung',
};
export default function RootLayout({ children }: { children: React.ReactNode }) {
return (
<html lang="de">
<body>
<Providers>{children}</Providers>
</body>
</html>
);
}
Verschachteltes Layout (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>
);
}
Template (app/tasks/template.tsx):
// Wird bei Navigation erneut ausgeführt, behält Formularzustand
export default function TasksTemplate({ children }: { children: React.ReactNode }) {
return (
<div className="bg-gray-50 min-h-screen">
<header className="bg-white shadow">
<h1>Aufgaben</h1>
</header>
{children}
</div>
);
}
5. Server vs. Client-Komponenten
Server-Komponenten verwenden für:
- Datenabruf
- Direkte Datenbankabfragen
- Statische Inhalte
- Server-seitige Operationen
Client-Komponenten ('use client') verwenden für:
- Browser-APIs (
window,localStorage) - Ereignisbehandler (
onClick,onSubmit) - React Hooks (
useState,useEffect) - Zustandsverwaltung (Zustand, Redux)
- Interaktivität
// Server-Komponente (Standard)
export default async function TaskList() {
const tasks = await fetchTasks(); // Direkte DB-Abfrage
return <div>{tasks.map(/* ... */)}</div>;
}
// Client-Komponente
'use client';
import { useTaskStore } from '@/store/tasks';
export function TaskFilter() {
const { filter, setFilter } = useTaskStore();
return <button onClick={() => setFilter('all')}>Alle Aufgaben</button>;
}
6. ERP-Rollen-basierte Seiten
Rollenberechtigungen (Role Guards):
// 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-Dashboard (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. Fehler- & Ladezustände
Fehlergrenze (error.tsx):
'use client';
export default function Error({
error,
reset,
}: {
error: Error & { digest?: string };
reset: () => void;
}) {
return (
<div>
<h2>Etwas ist schiefgelaufen!</h2>
<button onClick={reset}>Erneut versuchen</button>
</div>
);
}
Ladezustand (loading.tsx):
export default function Loading() {
return <div className="animate-pulse">Laden...</div>;
}
// Oder mit Suspense:
export default async function Page() {
return (
<Suspense fallback={<Loading />}>
<Content />
</Suspense>
);
}
8. shadcn/ui-Integration
Installation:
npx shadcn@latest add button card input dialog
Verwendung in Server-Komponenten:
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>Aufgaben</CardHeader>
<CardContent>
{tasks.map(task => (
<div key={task.id}>{task.title}</div>
))}
</CardContent>
</Card>
);
}
Entscheidungsbaum-Workflow
Benutzeranfrage → Analyse → Implementierungspfad
- **