Autor:
    Data utworzenia:2026-06-13Ostatnia aktualizacja:2026-06-13

    Migracja z i18next do Intlayer

    Aby zapoznać się z szczegółowym samouczkiem krok po kroku, zapraszamy do naszego pełnego Przewodnika migracji z i18next.

    Intlayer doskonale replikuje podstawowe charakterystyki czasu wykonywania i18next. Wykorzystując pakiet compat, twoje aplikacje Vanilla lub moduły wewnętrzne mogą nadal korzystać ze znanej składni.

    Co zrobić

    Aby rozpocząć, zainicjuj Intlayer w swoim projekcie:

    bash
    npx intlayer init

    Jeśli używasz Vite, dołącz plugin Intlayer aby przekierować importy do @intlayer/i18next:

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

    Co się dzieje za kulisami

    Plugin i18nextVitePlugin aliasuje importy i18next do @intlayer/i18next, unikając obciążenia bundle z włączeniami plików JSON.

    Za kulisami:

    • Konfiguracja instancji: createInstance poprawnie parsuje i stosuje rezerwowe ustawienia przestrzeni nazw, korzystając z rurociągu kompilacji Intlayer dla pobierania słownika.
    • Interpolacja: Natywna obsługa zamian {{name}} i zagnieżdżania $t(key) rekursywnie.
    • Kontekst i liczba mnoga: Identyfikuje i rozwiązuje formaty sufiksów takie jak key_male i key_one/key_other, obliczając względem standardu Intl.PluralRules.
    • Zwracanie obiektów: Tryb returnObjects: true bezpiecznie wyodrębnia drzewa ze słowników Intlayer.