Auteur:
    Création:2026-06-13Dernière mise à jour:2026-06-13

    Migrer de i18next vers Intlayer

    Pour un tutoriel détaillé étape par étape, veuillez consulter notre guide complet de migration i18next.

    Intlayer réplique parfaitement les caractéristiques d'exécution fondamentales de i18next. En utilisant le package compat, vos applications Vanilla ou modules internes peuvent continuer à exploiter la syntaxe familière.

    Que faire

    Pour commencer, initialisez Intlayer dans votre projet :

    bash
    npx intlayer init

    Si vous utilisez Vite, incluez le plugin Intlayer pour router les imports vers @intlayer/i18next :

    vite.config.ts
    import { defineConfig } from "vite";import { i18nextVitePlugin } from "@intlayer/i18next/plugin";export default defineConfig({  plugins: [i18nextVitePlugin()],});

    Ce qu'il fait sous le capot

    Le i18nextVitePlugin redirige les imports i18next vers @intlayer/i18next, évitant ainsi le gonflement du bundle causé par l'inclusion de fichiers JSON.

    Sous le capot :

    • Configuration d'instance : createInstance analyse correctement et applique les fallbacks de namespace tout en tirant parti du pipeline de compilation d'Intlayer pour la récupération des dictionnaires.
    • Interpolation : Support natif des remplacements {{name}} et imbrication $t(key) récursive.
    • Contexte & Pluriels : Identifie et résout les formats de suffixe comme key_male et key_one/key_other en évaluant par rapport à Intl.PluralRules standard.
    • Retour d'objets : Le mode returnObjects: true extrait de manière sécurisée les arbres des dictionnaires Intlayer.