Skip to content

i18next zur Laufzeit verdrahten ​

Diese Seite verdrahtet die Nachschlagefunktion zur Laufzeit. Sie erkennt keine Zeichenfolgen. Wenn die App noch unformatierte Literale in der Ausgangssprache enthält, umschließen Sie diese zuerst: i18n zu einer JS/TS-App hinzufügen. Die App installiert i18next und react-i18next, wenn Komponenten useTranslation() verwenden. ai-i18n-tools installiert keines der beiden Pakete.

Erstellen Sie Ihre i18n-Setup-Datei mit den von 'ai-i18n-tools/runtime' exportierten Hilfsprogrammen. API-Signaturen finden Sie unter Laufzeit-Hilfsprogramme.

Vollständiges i18n-Bootstrap-Beispiel (src/i18n.js)
js
// src/i18n.js or src/i18n.ts — use ../locales and ../public/locales instead of ./ when this file is under src/
import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';
import aiI18n from 'ai-i18n-tools/runtime';

// Project locale files — paths must match `ui` in ai-i18n-tools.config.json (paths there are relative to the project root).
import uiLanguages from './locales/ui-languages.json'; // `languagesManifestPath` (defaults to `{ui.flatOutputDir}/ui-languages.json`)
import stringsJson from './locales/strings.json'; // `ui.stringsJson`
import sourcePluralFlat from './public/locales/en-GB.json'; // `{ui.flatOutputDir}/{SOURCE_LOCALE}.json` from translate-ui

// Must match `sourceLocale` in ai-i18n-tools.config.json (same string as in the import path above)
export const SOURCE_LOCALE = 'en-GB';

// initialise i18n with the default options
void i18n.use(initReactI18next).init(aiI18n.defaultI18nInitOptions(SOURCE_LOCALE));

// set up the key-as-default translation
aiI18n.setupKeyAsDefaultT(i18n, {
  stringsJson,
  sourcePluralFlatBundle: { lng: SOURCE_LOCALE, bundle: sourcePluralFlat },
});

// apply the direction to the i18n instance
i18n.on('languageChanged', aiI18n.applyDirection);
aiI18n.applyDirection(i18n.language);

// create the locale loaders
const localeLoaders = aiI18n.makeLocaleLoadersFromManifest(
  uiLanguages,
  SOURCE_LOCALE,
  (code) => () => import(`./locales/${code}.json`),
);

// create the loadLocale function
export const loadLocale = aiI18n.makeLoadLocale(i18n, localeLoaders, SOURCE_LOCALE);

// export the i18n instance
export default i18n;

SOURCE_LOCALE synchron halten ​

sourceLocale kann eine beliebige Sprache sein. Das folgende Snippet verwendet en-GB als Beispiel. Halten Sie drei Werte aufeinander abgestimmt: sourceLocale in ai-i18n-tools.config.json, SOURCE_LOCALE in dieser Datei und das flache JSON für Pluralformen, das translate-ui als {sourceLocale}.json unter Ihrem flachen Ausgabeverzeichnis (oft public/locales/) schreibt. Verwenden Sie denselben Basisnamen in der statischen import (Beispiel oben: en-GB → en-GB.json). Das Feld lng in sourcePluralFlatBundle muss SOURCE_LOCALE entsprechen. Statische ES import-Pfade können keine Variablen verwenden; wenn Sie das Quell-Locale ändern, aktualisieren Sie SOURCE_LOCALE und den Importpfad gemeinsam. Alternativ laden Sie diese Datei mit einem dynamischen import(\./public/locales/${SOURCE_LOCALE}.json`), fetchoderreadFileSync, sodass der Pfad aus SOURCE_LOCALE` erstellt wird.

Der Snippet verwendet ./locales/… und ./public/locales/…, als ob i18n neben diesen Ordnern liegt. Wenn sich Ihre Datei unter src/ (typisch) befindet, verwenden Sie ../locales/… und ../public/locales/…, damit Importe zu denselben Pfaden wie ui.stringsJson, languagesManifestPath und ui.flatOutputDir aufgelöst werden.

Importieren Sie i18n.js, bevor React gerendert wird (z. B. am Anfang Ihres Einstiegspunkts). Wenn der Benutzer die Sprache ändert, rufen Sie await loadLocale(code) und dann await i18n.changeLanguage(code) auf.

Start-Locale ​

Rufen Sie loadLocale(saved) und dann i18n.changeLanguage(saved) vor dem ersten Rendern auf, nicht nur im Sprachumschalter. examples/console-app/src/main.js tut dies, bevor es ausgibt. In Next.js führt das Lesen von localStorage in einem Effekt nach der Hydration dazu, dass zuerst das Quell-Locale angezeigt wird, was zu einer Diskrepanz mit dem Server-HTML führen kann. Bevorzugen Sie ein Cookie, das der Server lesen kann, oder laden Sie das gespeicherte Locale im Client-Modul vor dem ersten Client-Rendern.

SOURCE_LOCALE wird exportiert, damit jede andere Datei, die es benötigt (z. B. ein Sprachwechsler), es direkt aus './i18n' importieren kann. Wenn Sie eine bestehende i18next-Konfiguration migrieren, ersetzen Sie alle hartkodierten Quell-Sprachcodes (z. B. 'en-GB'-Prüfungen, die in Komponenten verstreut sind) durch Importe von SOURCE_LOCALE aus Ihrer i18n-Bootstrap-Datei.

Benannte Imports (import { defaultI18nInitOptions, … } from 'ai-i18n-tools/runtime') funktionieren genauso, falls Sie den Default-Export nicht verwenden möchten.

Locale-Lader ​

Halten Sie localeLoaders mit der Konfiguration synchron, indem Sie sie aus ui-languages.json mithilfe von makeLocaleLoadersFromManifest ableiten (dadurch werden SOURCE_LOCALE mit derselben Normalisierung wie makeLoadLocale herausgefiltert). Wenn Sie eine Sprache zu targetLocales hinzufügen und generate-ui-languages ausführen, wird das Manifest aktualisiert und Ihre Lader verfolgen die Änderung automatisch – es ist nicht nötig, eine separate hartkodierte Zuordnung zu pflegen.

Für JSON-Bundles unter public/ (die typische Next.js-Setup-Konfiguration) rufen Sie sie über Ihren öffentlichen URL-Pfad ab:

js
(code) => () => fetch(`/locales/${code}.json`).then(res => res.json())

Für Node.js-CLIs ohne Bundler verwenden Sie readFileSync innerhalb eines kleinen Hilfsprogramms, das die JSON-Datei für jeden Code liest und analysiert.

Verwenden Sie setupKeyAsDefaultT als üblichen App-Einstiegspunkt (Schlüsselkürzung + Plural wrapT + optionaler translate-ui {sourceLocale}.json). Der alleinige Aufruf von wrapI18nWithKeyTrim ist für die Anwendungsverdrahtung veraltet – siehe Laufzeit-Hilfsprogramme.

Veröffentlicht unter der MIT-Lizenz.