Автор:
    Aymeric PINEAU
    Дата створення:2026-01-21Останнє оновлення:2026-01-21

    Пакет next-intlayer

    Пакет next-intlayer надає необхідні інструменти для інтеграції Intlayer у додатки Next.js. Він підтримує як App Router, так і Page Router, включно з middleware для маршрутизації залежно від локалі.

    Встановлення

    bash
    npm install next-intlayer

    Експорти

    Middleware

    Імпорт:

    tsx
    import "next-intlayer/middleware";
    ФункціяОписПов'язана документація
    intlayerMiddlewareMiddleware для Next.js, що обробляє маршрутизацію та редиректи на основі локалі. Визначає локаль із заголовків (headers) або cookies і перенаправляє на відповідний шлях локалі.intlayerMiddleware

    Помічники конфігурації

    Імпорт:

    tsx
    import "next-intlayer/server";
    ФункціяОписПов'язана документація
    withIntlayerАсинхронний хелпер для обгортання конфігурації Next.js, що забезпечує підготовку словників Intlayer перед збіркою. Підготовлює файли контенту та налаштовує плагіни webpack/SWC.-
    withIntlayerSyncСинхронний хелпер для обгортання конфігурації Next.js, ідеальний для конфігурацій, де асинхронність неможлива або небажана. Не готує словники на старті сервера.-

    Провайдери

    Імпорт:

    tsx
    import "next-intlayer";

    або

    tsx
    import "next-intlayer/server";
    КомпонентОписПов'язана документація
    IntlayerClientProviderПровайдер для клієнтських компонентів у Next.js App Router. Обгортає IntlayerProvider з react-intlayer.-
    IntlayerServerProviderПровайдер для серверних компонентів у Next.js (App Router). Надає контекст локалі на сервері.-
    IntlayerServerСерверна обгортка для контенту Intlayer у App Router. Забезпечує коректну обробку локалі в Server Components.-

    Хуки (на стороні клієнта)

    Імпорт:

    tsx
    import "next-intlayer";

    Повторно експортує більшість хуків із react-intlayer.

    ХукОписПов'язаний документ
    useIntlayerКлієнтський хук, який вибирає один словник за його ключем і повертає його вміст. Використовує locale з контексту, якщо не вказано.useIntlayer
    useDictionaryХук, який перетворює об'єкт dictionary і повертає вміст для поточного locale. Обробляє переклади t(), перерахування тощо.useDictionary
    useDictionaryAsyncХук, що працює з асинхронними словниками. Приймає мапу словників на основі Promise і отримує дані для поточної локалі.-
    useDictionaryDynamicХук, який обробляє динамічні словники, завантажувані за ключем. Внутрішньо використовує React Suspense для станів завантаження.-
    useLocaleКлієнтський хук для отримання поточної локалі та функції для її встановлення. Розширений для Next.js App Router з підтримкою навігації.useLocale
    usePathnameПовертає поточний шлях без префікса локалі та без параметрів запиту локалі.usePathname
    useRewriteURLКлієнтський хук для керування переписуванням URL. Автоматично оновлює URL, якщо існує більш естетичне локалізоване правило переписування.useRewriteURL
    useLocalePageRouterСпецифічний для Next.js Page Router хук для керування локаллю. Обробляє перенаправлення та перезавантаження сторінки при зміні локалі.-
    useI18nХук, який надає функцію перекладу t() для доступу до вкладеного вмісту за ключем. Імітує патерн i18next/next-intl.useI18n
    useIntlХук, який надає зв'язаний із локаллю об'єкт Intl. Автоматично підставляє поточну локаль і використовує оптимізоване кешування.-
    useLoadDynamicХук для завантаження динамічних словників за допомогою React Suspense. Приймає ключ і проміс, кешує результати.-

    Функції (Server-side)

    Імпорт:

    tsx
    import "next-intlayer/server";
    ФункціяОписПов'язана документація
    tСерверна версія функції перекладу для Next.js App Router. Повертає переклад багатомовного контенту для поточної серверної локалі.translation
    getLocaleДопоміжна функція для отримання поточної локалі з заголовків і cookie Next.js. Призначена для Server Components, Server Actions або Route Handlers.-
    generateStaticParamsГенерує статичні параметри для динамічних маршрутів Next.js на основі налаштованих локалей. Повертає масив об'єктів локалі для попереднього рендерингу.-
    localeФункція для отримання або встановлення локалі в серверному контексті (App Router). Забезпечує керування локаллю в Server Components.-

    Типи

    Імпорт:

    tsx
    import "next-intlayer";
    ТипОпис
    NextPageIntlayerТип для Next.js pages з підтримкою Intlayer. Generic type, що включає параметр locale.
    Next14PageIntlayerТип для Next.js 14 pages з підтримкою Intlayer.
    Next15PageIntlayerТип для Next.js 15 pages з підтримкою Intlayer.
    NextLayoutIntlayerТип для Next.js layouts з підтримкою Intlayer. Generic type, що включає параметр locale.
    Next14LayoutIntlayerТип для layout-ів Next.js 14 з підтримкою Intlayer.
    Next15LayoutIntlayerТип для layout-ів Next.js 15 з підтримкою Intlayer.
    LocalParamsТип для параметрів маршруту Next.js з локаллю. Об'єкт з властивістю locale.
    LocalPromiseParamsТип для параметрів маршруту Next.js з локаллю (асинхронна версія). Promise, що розв'язується в об'єкт з властивістю locale.
    useRewriteURLintlayerMiddleware