Was macht next-intl?
Übersicht
next-intl ist die führende i18n-Bibliothek für Next.js App Router. Sie behandelt Locale-Routing, Nachrichtenübersetzung, Datums-/Zahlenformatierung und funktioniert sowohl mit Server- als auch mit Client-Komponenten. ICU-Nachrichtensyntax für Pluralformen und Variablen.
Anleitung
Schritt 1: Einrichtung
npm install next-intl
// i18n/request.ts — Locale-Erkennung
import { getRequestConfig } from 'next-intl/server'
export default getRequestConfig(async ({ requestLocale }) => {
const locale = await requestLocale || 'en'
return {
locale,
messages: (await import(`../messages/${locale}.json`)).default,
}
})
// messages/en.json
{
"HomePage": {
"title": "Willkommen bei {appName}",
"description": "Das beste Tool für {count, plural, one {# Team} other {# Teams}}",
"cta": "Jetzt starten"
},
"Dashboard": {
"greeting": "Hallo, {name}",
"lastLogin": "Letzter Login: {date, date, medium}"
}
}
// messages/de.json
{
"HomePage": {
"title": "Willkommen bei {appName}",
"description": "Das beste Tool für {count, plural, one {# Team} other {# Teams}}",
"cta": "Jetzt starten"
}
}
Schritt 2: Server-Komponenten
// app/[locale]/page.tsx — Übersetzte Server-Komponente
import { useTranslations } from 'next-intl'
export default function HomePage() {
const t = useTranslations('HomePage')
return (
<main>
<h1>{t('title', { appName: 'MyApp' })}</h1>
<p>{t('description', { count: 5000 })}</p>
<a href="/signup">{t('cta')}</a>
</main>
)
}
Schritt 3: Middleware-Routing
// middleware.ts — Locale-Routing
import createMiddleware from 'next-intl/middleware'
export default createMiddleware({
locales: ['en', 'de', 'fr', 'ja'],
defaultLocale: 'en',
localePrefix: 'as-needed', // /de/about aber /about (für en)
})
export const config = { matcher: ['/((?!api|_next|.*\\..*).*)'] }
Richtlinien
- ICU-Nachrichtensyntax:
{count, plural, one {# Element} other {# Elemente}}für Pluralformen. - Server-Komponenten:
useTranslations()direkt verwenden, kein Kontext erforderlich. - Client-Komponenten: Mit
NextIntlClientProviderumschließen. - Nachrichtenschlüssel nach Seite/Komponente für Wartbarkeit ordnen.
localePrefix: 'as-needed'verwenden, um das Präfix/enfür die Standard-Locale zu vermeiden.