Autor:
    Aymeric PINEAU
    Data utworzenia:2026-01-21Ostatnia aktualizacja:2026-01-21

    Pakiet next-intlayer

    Pakiet next-intlayer dostarcza narzędzia niezbędne do integracji Intlayer z aplikacjami Next.js. Obsługuje zarówno App Router, jak i Page Router, w tym middleware do trasowania opartego na locale.

    Instalacja

    bash
    npm install next-intlayer

    Eksporty

    Middleware

    Import:

    tsx
    import "next-intlayer/middleware";
    FunkcjaOpisPowiązana dokumentacja
    intlayerMiddlewareMiddleware Next.js do obsługi routingu opartego na lokalizacji i przekierowań. Wykrywa lokalizację na podstawie nagłówków/cookies i przekierowuje do odpowiedniej ścieżki z lokalizacją.intlayerMiddleware

    Pomocniki konfiguracji

    Import:

    tsx
    import "next-intlayer/server";
    FunkcjaOpisPowiązany dokument
    withIntlayerAsynchroniczny pomocnik do opakowywania konfiguracji Next.js, zapewniający przygotowanie słowników Intlayer przed buildem. Przygotowuje pliki z treścią i konfiguruje wtyczki webpack/SWC.-
    withIntlayerSyncSynchroniczny pomocnik do opakowywania konfiguracji Next.js, idealny dla konfiguracji, w których async nie jest możliwy/pożądany. Nie przygotowuje słowników przy starcie serwera.-

    Providery

    Import:

    tsx
    import "next-intlayer";

    or

    tsx
    import "next-intlayer/server";
    KomponentOpisPowiązany dokument
    IntlayerClientProviderProvider dla komponentów po stronie klienta w Next.js App Router. Opakowuje IntlayerProvider z react-intlayer.-
    IntlayerServerProviderProvider dla komponentów po stronie serwera w Next.js (App Router). Zapewnia kontekst locale na serwerze.-
    IntlayerServerSerwerowy wrapper dla zawartości Intlayer w App Router. Zapewnia prawidłowe zarządzanie locale w Server Components.-

    Hooki (po stronie klienta)

    Import:

    tsx
    import "next-intlayer";

    Ponownie eksportuje większość hooków z react-intlayer.

    HookOpisPowiązany dokument
    useIntlayerHook po stronie klienta, który wybiera słownik po jego kluczu i zwraca jego zawartość. Używa locale z kontekstu, jeśli nie podano.useIntlayer
    useDictionaryHook, który przekształca obiekt słownika i zwraca zawartość dla bieżącego locale. Przetwarza tłumaczenia t(), enumeracje itp.useDictionary
    useDictionaryAsyncHook obsługujący asynchroniczne słowniki. Akceptuje mapę słowników opartą na Promise i rozwiązuje ją dla bieżącego locale.-
    useDictionaryDynamicHook obsługujący dynamiczne słowniki ładowane po kluczu. Wewnątrz wykorzystuje React Suspense do obsługi stanów ładowania.-
    useLocaleHook po stronie klienta do pobierania bieżącego locale i funkcji do jego ustawiania. Rozszerzony dla Next.js App Router o wsparcie nawigacji.useLocale
    usePathnameZwraca aktualną ścieżkę bez prefiksu ustawień regionalnych i bez parametrów zapytania związanych z ustawieniami regionalnymi.usePathname
    useRewriteURLHook po stronie klienta do zarządzania przepisywaniem URL. Automatycznie aktualizuje URL, jeśli istnieje bardziej estetyczna zlokalizowana reguła przepisywania.useRewriteURL
    useLocalePageRouterHook specyficzny dla Next.js Page Router do zarządzania locale. Obsługuje przekierowania i przeładowania strony przy zmianie locale.-
    useI18nHook, który udostępnia funkcję tłumaczącą t() do dostępu do zagnieżdżonych treści po kluczu. Imituje wzorzec i18next/next-intl.useI18n
    useIntlHook, który dostarcza związany z lokalizacją obiekt Intl. Automatycznie wstrzykuje aktualną lokalizację i korzysta z zoptymalizowanego cachowania.-
    useLoadDynamicHook do ładowania dynamicznych słowników z użyciem React Suspense. Przyjmuje klucz i promise, buforuje wyniki.-

    Funkcje (po stronie serwera)

    Import:

    tsx
    import "next-intlayer/server";
    FunkcjaOpisPowiązany dokument
    tWersja po stronie serwera funkcji tłumaczeniowej dla Next.js App Router. Zwraca tłumaczenie wielojęzycznych treści dla lokalizacji serwera.translation
    getLocaleFunkcja pomocnicza do wyodrębniania bieżącej lokalizacji z nagłówków i cookies Next.js. Zaprojektowana dla Server Components, Server Actions lub Route Handlers.-
    generateStaticParamsGeneruje statyczne parametry dla dynamicznych tras Next.js na podstawie skonfigurowanych lokalizacji. Zwraca tablicę obiektów locale do wstępnego renderowania.-
    localeFunkcja do pobierania lub ustawiania locale w kontekście serwera (App Router). Zapewnia zarządzanie locale w Server Components.-

    Typy

    Import:

    tsx
    import "next-intlayer";
    TypOpis
    NextPageIntlayerTyp dla stron Next.js ze wsparciem Intlayer. Typ generyczny, który zawiera parametr locale.
    Next14PageIntlayerTyp dla stron Next.js 14 ze wsparciem Intlayer.
    Next15PageIntlayerTyp dla stron Next.js 15 ze wsparciem Intlayer.
    NextLayoutIntlayerTyp dla layoutów Next.js ze wsparciem Intlayer. Typ generyczny, który zawiera parametr locale.
    Next14LayoutIntlayerTyp dla layoutów Next.js 14 z obsługą Intlayer.
    Next15LayoutIntlayerTyp dla layoutów Next.js 15 z obsługą Intlayer.
    LocalParamsTyp dla parametrów trasy Next.js z lokalizacją. Obiekt z właściwością locale.
    LocalPromiseParamsTyp dla parametrów trasy Next.js z lokalizacją (wersja asynchroniczna). Promise, który rozwiązuje się do obiektu z właściwością locale.
    useRewriteURLintlayerMiddleware