Autor:
    Aymeric PINEAU
    Criação:2026-01-21Última atualização:2026-01-21

    Pacote next-intlayer

    O pacote next-intlayer fornece as ferramentas necessárias para integrar o Intlayer em aplicações Next.js. Ele oferece suporte tanto ao App Router quanto ao Page Router, incluindo middleware para roteamento baseado em locale.

    Instalação

    bash
    npm install next-intlayer

    Exportações

    Middleware

    Importação:

    tsx
    import "next-intlayer/middleware";
    FunçãoDescriçãoDoc Relacionado
    intlayerMiddlewareMiddleware do Next.js para lidar com roteamento e redirecionamentos baseados em locale. Detecta o locale a partir dos headers/cookies e redireciona para o caminho de locale apropriado.intlayerMiddleware

    Auxiliares de Configuração

    Import:

    tsx
    import "next-intlayer/server";
    FunçãoDescriçãoDoc Relacionado
    withIntlayerAuxiliar assíncrono para envolver a configuração do Next.js, garantindo que os dicionários do Intlayer estejam preparados antes da build. Prepara arquivos de conteúdo e configura plugins do webpack/SWC.-
    withIntlayerSyncAuxiliar síncrono para envolver a configuração do Next.js, ideal para configurações onde async não é possível/desejado. Não prepara os dicionários na inicialização do servidor.-

    Provedores

    Importar:

    tsx
    import "next-intlayer";

    ou

    tsx
    import "next-intlayer/server";
    ComponenteDescriçãoDoc Relacionado
    IntlayerClientProviderProvider para componentes do lado do cliente no Next.js App Router. Envolve o IntlayerProvider do react-intlayer.-
    IntlayerServerProviderProvider para componentes do lado do servidor no Next.js (App Router). Fornece o contexto de locale no servidor.-
    IntlayerServerWrapper do lado do servidor para conteúdo do Intlayer no App Router. Garante o tratamento adequado de locale em Server Components.-
    HTMLProviderProvider para configurações de internacionalização relacionadas a HTML. Permite sobrescrever componentes para tags HTML.-
    HTMLRendererRenderiza conteúdo HTML com componentes personalizados.-
    MarkdownProviderProvider para o contexto de renderização Markdown. Permite sobrescrever componentes personalizados para elementos Markdown.-
    MarkdownRendererRenderiza conteúdo Markdown com componentes personalizados.-

    Hooks (Lado do Cliente)

    Importação:

    tsx
    import "next-intlayer";

    Re-exporta a maioria dos hooks de react-intlayer.

    HookDescriçãoDocumento Relacionado
    useIntlayerHook do lado do cliente que seleciona um dicionário pela sua key e retorna seu conteúdo. Usa a locale do contexto se não for fornecida.useIntlayer
    useDictionaryHook que transforma um objeto dicionário e retorna o conteúdo para a locale atual. Processa traduções t(), enumerações, etc.useDictionary
    useDictionaryAsyncHook que lida com dicionários assíncronos. Aceita um mapa de dicionários baseado em Promise e resolve-o para o locale atual.-
    useDictionaryDynamicHook que lida com dicionários dinâmicos carregados por chave. Usa React Suspense internamente para estados de carregamento.-
    useLocaleHook do lado do cliente para obter a locale atual e uma função para defini-la. Aprimorado para o App Router do Next.js com suporte à navegação.useLocale
    usePathnameRetorna o caminho atual sem o prefixo da localidade e sem os parâmetros de consulta da localidade.usePathname
    useRewriteURLHook do lado do cliente para gerenciar reescritas de URL. Atualiza automaticamente a URL se existir uma regra de reescrita localizada mais legível.useRewriteURL
    useLocalePageRouterHook específico do Page Router do Next.js para gerenciamento de locale. Trata redirecionamentos e recarregamentos de página ao alterar o locale.-
    useI18nHook que fornece uma função de tradução t() para acessar conteúdo aninhado por chave. Imita o padrão i18next/next-intl.useI18n
    useIntlHook que fornece um objeto Intl vinculado à locale. Injeta automaticamente a locale atual e utiliza cache otimizado.-
    useLoadDynamicHook para carregar dicionários dinâmicos usando React Suspense. Aceita uma chave e uma promise, e faz cache dos resultados.-
    useHTMLRendererHook para obter uma função de renderização de HTML pré-configurada.-
    useMarkdownRendererHook para obter uma função de renderização de Markdown pré-configurada.-

    Funções (Server-side)

    Importe:

    tsx
    import "next-intlayer/server";
    FunçãoDescriçãoDocumento relacionado
    tVersão do lado do servidor da função de tradução para o Next.js App Router. Retorna a tradução de conteúdo multilíngue para a locale do servidor.translation
    getLocaleFunção helper para extrair a locale atual a partir dos headers e cookies do Next.js. Projetada para Server Components, Server Actions ou Route Handlers.-
    generateStaticParamsGera parâmetros estáticos para as rotas dinâmicas do Next.js com base nas locales configuradas. Retorna um array de objetos de locale para pré-renderização.-
    localeFunção para obter ou definir o locale no contexto do servidor (App Router). Fornece gerenciamento de locale em Server Components.-

    Tipos

    Import:

    tsx
    import "next-intlayer";
    TipoDescrição
    NextPageIntlayerTipo para páginas Next.js com suporte ao Intlayer. Tipo genérico que inclui parâmetro de locale.
    Next14PageIntlayerTipo para páginas Next.js 14 com suporte ao Intlayer.
    Next15PageIntlayerTipo para páginas Next.js 15 com suporte ao Intlayer.
    NextLayoutIntlayerTipo para layouts Next.js com suporte ao Intlayer. Tipo genérico que inclui parâmetro de locale.
    Next14LayoutIntlayerTipo para layouts do Next.js 14 com suporte ao Intlayer.
    Next15LayoutIntlayerTipo para layouts do Next.js 15 com suporte ao Intlayer.
    LocalParamsTipo para parâmetros de rota do Next.js com locale. Objeto com propriedade locale.
    LocalPromiseParamsTipo para parâmetros de rota do Next.js com locale (versão assíncrona). Promise que resolve para um objeto com propriedade locale.
    useRewriteURLintlayerMiddleware