Que fait next-intl ?
Vue d'ensemble
next-intl est la bibliothèque d'internationalisation (i18n) de référence pour Next.js App Router. Elle gère le routage par locale, la traduction des messages, le formatage des dates et des nombres, et fonctionne aussi bien avec les composants serveur que client. Syntaxe de messages ICU pour les pluriels et les variables.
Instructions
Étape 1 : Configuration
npm install next-intl
// i18n/request.ts — Détection de la locale
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": "Bienvenue sur {appName}",
"description": "Le meilleur outil pour {count, plural, one {# équipe} other {# équipes}}",
"cta": "Commencer"
},
"Dashboard": {
"greeting": "Bonjour, {name}",
"lastLogin": "Dernière connexion : {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"
}
}
Étape 2 : Composants serveur
// app/[locale]/page.tsx — Composant serveur traduit
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>
)
}
Étape 3 : Routage via middleware
// middleware.ts — Routage par locale
import createMiddleware from 'next-intl/middleware'
export default createMiddleware({
locales: ['en', 'de', 'fr', 'ja'],
defaultLocale: 'en',
localePrefix: 'as-needed', // /de/about mais /about (pour en)
})
export const config = { matcher: ['/((?!api|_next|.*\..*).*)'] }
Recommandations
- Syntaxe de messages ICU :
{count, plural, one {# élément} other {# éléments}}pour les pluriels. - Composants serveur : utilisez
useTranslations()directement, pas de contexte nécessaire. - Composants clients : enveloppez avec
NextIntlClientProvider. - Gardez les clés de messages organisées par page/composant pour une maintenance aisée.
- Utilisez
localePrefix: 'as-needed'pour éviter le préfixe /en/ pour la locale par défaut.