Migration von i18next zu Intlayer

Für ein detailliertes Schritt-für-Schritt-Tutorial lesen Sie bitte unsere vollständige i18next Migrationsanleitung.

Intlayer repliziert die wichtigsten Laufzeiteigenschaften von i18next perfekt. Durch die Verwendung des Compat-Pakets können Ihre Vanilla-Anwendungen oder internen Module die vertraute Syntax weiterhin nutzen.

Was zu tun ist

Um zu beginnen, initialisieren Sie Intlayer in Ihrem Projekt:

npx intlayer init

Wenn Sie Vite verwenden, fügen Sie das Intlayer-Plugin hinzu, um Imports zu @intlayer/i18next weiterzuleiten:

import { defineConfig } from "vite";
import { i18nextVitePlugin } from "@intlayer/i18next/plugin";

export default defineConfig({
  plugins: [i18nextVitePlugin()],
});

Was im Hintergrund geschieht

Das i18nextVitePlugin aliasiert i18next-Imports zu @intlayer/i18next und vermeidet so Bundle-Aufblähung durch JSON-Datei-Einschlüsse.

Im Hintergrund:

• Instanzkonfiguration: createInstance analysiert und wendet Namespace-Fallbacks korrekt an und nutzt dabei Intlayers Kompilierungs-Pipeline für den Wörterbuchabruf.
• Interpolation: Native Unterstützung für {{name}}-Ersetzungen und rekursives $t(key)-Verschachteln.
• Kontext & Plurale: Identifiziert und löst Suffix-Formate wie key_male und key_one/key_other auf, die gegen Standard-Intl.PluralRules ausgewertet werden.
• Rückgabeobjekte: Der Modus returnObjects: true extrahiert sicher Bäume aus Intlayer-Wörterbüchern.