¿Qué hace i18next?
Descripción general
i18next es el framework de internacionalización (i18n) más popular para JavaScript. Funciona con React, Vue, Angular, Node.js. Características: separación en espacios de nombres, carga diferida, plurales, interpolación, contexto y plugins de backend para traducciones remotas.
Instrucciones
Paso 1: Configuración en React
import i18n from 'i18next'
import { initReactI18next } from 'react-i18next'
import HttpBackend from 'i18next-http-backend'
import LanguageDetector from 'i18next-browser-languagedetector'
i18n.use(HttpBackend).use(LanguageDetector).use(initReactI18next).init({
fallbackLng: 'en',
supportedLngs: ['en', 'de', 'fr', 'ja'],
ns: ['common', 'dashboard'],
defaultNS: 'common',
backend: { loadPath: '/locales/{{lng}}/{{ns}}.json' },
})
Paso 2: Uso
import { useTranslation, Trans } from 'react-i18next'
function Dashboard() {
const { t } = useTranslation('dashboard')
return (
<div>
<h1>{t('welcome', { name: 'Alice' })}</h1>
<p>{t('projects', { count: 5 })}</p>
<Trans i18nKey="terms">Acepta los <a href="/terms">Términos</a>.</Trans>
</div>
)
}
{
"welcome": "¡Bienvenido de nuevo, {{name}}!",
"projects_one": "Tienes {{count}} proyecto",
"projects_other": "Tienes {{count}} proyectos"
}
Directrices
- Divide las traducciones en espacios de nombres por funcionalidad — no cargues todo.
- Usa los sufijos
_one/_otherpara plurales. - Usa
<Trans>para traducciones con JSX incrustado. - Detección de idioma: navegador → URL → cookie → localStorage.
- Para SSR: pasa el idioma desde el servidor para evitar desajustes de hidratación.