Autore:
    Aymeric PINEAU
    Creazione:2026-01-21Ultimo aggiornamento:2026-01-21

    Pacchetto next-intlayer

    Il pacchetto next-intlayer fornisce gli strumenti necessari per integrare Intlayer in applicazioni Next.js. Supporta sia l'App Router che il Page Router, incluso il middleware per il routing basato sulla locale.

    Installazione

    bash
    npm install next-intlayer

    Esportazioni

    Middleware

    Importazione:

    tsx
    import "next-intlayer/middleware";
    FunzioneDescrizioneDocumento correlato
    intlayerMiddlewareMiddleware di Next.js per gestire il routing basato sulla locale e i redirect. Rileva la locale dagli header/cookie e reindirizza al percorso appropriato per la locale.intlayerMiddleware

    Helper di configurazione

    Importa:

    tsx
    import "next-intlayer/server";
    FunzioneDescrizioneDoc correlata
    withIntlayerHelper asincrono per avvolgere la configurazione di Next.js, garantendo che i dizionari di Intlayer siano preparati prima della build. Prepara i file di contenuto e configura i plugin per webpack/SWC.-
    withIntlayerSyncHelper sincrono per avvolgere la configurazione di Next.js, ideale per configurazioni in cui l'async non è possibile o non è desiderato. Non prepara i dizionari all'avvio del server.-

    Provider

    Importazione:

    tsx
    import "next-intlayer";

    or

    tsx
    import "next-intlayer/server";
    ComponenteDescrizioneDocumentazione correlata
    IntlayerClientProviderProvider per componenti lato client nell'App Router di Next.js. Avvolge IntlayerProvider di react-intlayer.-
    IntlayerServerProviderProvider per componenti lato server in Next.js (App Router). Fornisce il contesto della locale sul server.-
    IntlayerServerWrapper lato server per i contenuti Intlayer nell'App Router. Garantisce la gestione corretta della locale nei Server Components.-
    HTMLProviderProvider per le impostazioni di internazionalizzazione relative a HTML. Consente di sovrascrivere i componenti per i tag HTML.-
    HTMLRendererRenderizza contenuti HTML con componenti personalizzati.-
    MarkdownProviderProvider per il contesto di rendering Markdown. Consente di sovrascrivere componenti personalizzati per gli elementi Markdown.-
    MarkdownRendererRenderizza contenuti Markdown con componenti personalizzati.-

    Hook (lato client)

    Importazione:

    tsx
    import "next-intlayer";

    Re-esporta la maggior parte degli hook da react-intlayer.

    HookDescrizioneDoc correlata
    useIntlayerHook lato client che seleziona un dizionario tramite la sua chiave e ne restituisce il contenuto. Usa la locale dal contesto se non fornita.useIntlayer
    useDictionaryHook che trasforma un oggetto dizionario e restituisce il contenuto per la locale corrente. Elabora le traduzioni t(), enumerazioni, ecc.useDictionary
    useDictionaryAsyncHook che gestisce dizionari asincroni. Accetta una mappa di dizionari basata su Promise e la risolve per la locale corrente.-
    useDictionaryDynamicHook che gestisce dizionari dinamici caricati per chiave. Utilizza internamente React Suspense per gli stati di caricamento.-
    useLocaleHook lato client per ottenere la locale corrente e una funzione per impostarla. Migliorato per Next.js App Router con supporto alla navigazione.useLocale
    usePathnameRestituisce il percorso attuale senza il prefisso della lingua e senza i parametri di query della lingua.usePathname
    useRewriteURLHook lato client per gestire la riscrittura degli URL. Aggiorna automaticamente l'URL se esiste una regola di riscrittura localizzata più pulita.useRewriteURL
    useLocalePageRouterHook specifico per il Page Router di Next.js per la gestione della localizzazione. Gestisce i redirect e i ricaricamenti della pagina al cambio di locale.-
    useI18nHook che fornisce una funzione di traduzione t() per accedere a contenuti nidificati tramite chiave. Riprende il pattern di i18next/next-intl.useI18n
    useIntlHook che fornisce un oggetto Intl vincolato alla locale. Inietta automaticamente la locale corrente e utilizza caching ottimizzato.-
    useLoadDynamicHook per caricare dizionari dinamici usando React Suspense. Accetta una chiave e una Promise, memorizza i risultati in cache.-
    useHTMLRendererHook per ottenere una funzione di rendering HTML preconfigurata.-
    useMarkdownRendererHook per ottenere una funzione di rendering Markdown preconfigurata.-

    Funzioni (Server-side)

    Importazione:

    tsx
    import "next-intlayer/server";
    FunzioneDescrizioneDoc correlata
    tVersione server-side della funzione di traduzione per Next.js App Router. Restituisce la traduzione di contenuti multilingue per la locale del server.translation
    getLocaleFunzione helper per estrarre la locale corrente dagli header e dai cookie di Next.js. Progettata per Server Components, Server Actions o Route Handlers.-
    generateStaticParamsGenera parametri statici per le route dinamiche di Next.js basate sulle localizzazioni configurate. Restituisce un array di oggetti locale per il pre-rendering.-
    localeFunzione per ottenere o impostare la locale nel contesto server (App Router). Fornisce la gestione della locale nei Server Components.-

    Tipi

    Importazione:

    tsx
    import "next-intlayer";
    TipoDescrizione
    NextPageIntlayerTipo per le pagine di Next.js con supporto Intlayer. Tipo generico che include il parametro locale.
    Next14PageIntlayerTipo per le pagine di Next.js 14 con supporto Intlayer.
    Next15PageIntlayerTipo per le pagine di Next.js 15 con supporto Intlayer.
    NextLayoutIntlayerTipo per i layout di Next.js con supporto Intlayer. Tipo generico che include il parametro locale.
    Next14LayoutIntlayerTipo per i layout di Next.js 14 con supporto Intlayer.
    Next15LayoutIntlayerTipo per i layout di Next.js 15 con supporto Intlayer.
    LocalParamsTipo per i parametri di route di Next.js con locale. Oggetto con proprietà locale.
    LocalPromiseParamsTipo per i parametri di route di Next.js con locale (versione asincrona). Promise che risolve in un oggetto con proprietà locale.
    useRewriteURLintlayerMiddleware