¿Qué hace next-intl?
Resumen
next-intl es la biblioteca de i18n líder para Next.js App Router. Maneja enrutamiento de locale, traducción de mensajes, formato de fecha/número y funciona con componentes de servidor y cliente. Sintaxis de mensajes ICU para plurales y variables.
Instrucciones
Paso 1: Configuración
npm install next-intl
// i18n/request.ts — Detección de 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": "Bienvenido a {appName}",
"description": "La mejor herramienta para {count, plural, one {# equipo} other {# equipos}}",
"cta": "Comenzar"
},
"Dashboard": {
"greeting": "Hola, {name}",
"lastLogin": "Último inicio de sesión: {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"
}
}
Paso 2: Componentes de Servidor
// app/[locale]/page.tsx — Componente de servidor traducido
import { useTranslations } from 'next-intl'
export default function HomePage() {
const t = useTranslations('HomePage')
return (
<main>
<h1>{t('title', { appName: 'MiApp' })}</h1>
<p>{t('description', { count: 5000 })}</p>
<a href="/registro">{t('cta')}</a>
</main>
)
}
Paso 3: Enrutamiento con Middleware
// middleware.ts — Enrutamiento por locale
import createMiddleware from 'next-intl/middleware'
export default createMiddleware({
locales: ['en', 'de', 'fr', 'ja'],
defaultLocale: 'en',
localePrefix: 'as-needed', // /de/acerca-de pero /acerca-de (para en)
})
export const config = { matcher: ['/((?!api|_next|.*\..*).*)'] }
Pautas
- Sintaxis de mensajes ICU:
{count, plural, one {# elemento} other {# elementos}}para plurales. - Componentes de servidor: usa
useTranslations()directamente, sin necesidad de contexto. - Componentes de cliente: envuélvelos con
NextIntlClientProvider. - Mantén las claves de mensajes organizadas por página/componente para facilitar el mantenimiento.
- Usa
localePrefix: 'as-needed'para evitar el prefijo /en/ para el locale predeterminado.