Was macht i18next?
Übersicht
i18next ist das beliebteste JavaScript i18n-Framework. Funktioniert mit React, Vue, Angular, Node.js. Bietet Namensraumaufteilung, Lazy Loading, Pluralformen, Interpolation, Kontext und Backend-Plugins für Remote-Übersetzungen.
Anleitung
Schritt 1: React Einrichtung
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' },
})
Schritt 2: Verwendung
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">Stimme <a href="/terms">Nutzungsbedingungen</a> zu.</Trans>
</div>
)
}
{
"welcome": "Willkommen zurück, {{name}}!",
"projects_one": "Du hast {{count}} Projekt",
"projects_other": "Du hast {{count}} Projekte"
}
Richtlinien
- Übersetzungen nach Funktionen in Namensräume aufteilen – nicht alles auf einmal laden.
- Für Pluralformen die Suffixe
_one/_otherverwenden. <Trans>für Übersetzungen mit eingebettetem JSX nutzen.- Spracherkennung: Browser → URL → Cookie → localStorage.
- Bei SSR: Sprache vom Server übergeben, um Hydratationskonflikte zu vermeiden.