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

    Pacchetto react-intlayer

    Il pacchetto react-intlayer fornisce gli strumenti necessari per integrare Intlayer nelle applicazioni React. Include provider di contesto, hook e componenti per la gestione dei contenuti multilingue.

    Installazione

    bash
    npm install react-intlayer

    Esportazioni

    Provider

    Importazione:

    tsx
    import "react-intlayer";
    ComponenteDescrizioneDocumento correlato
    IntlayerProviderIl provider principale che avvolge la tua applicazione e fornisce il contesto Intlayer. Include il supporto dell'editor di default.IntlayerProvider
    IntlayerProviderContentUn componente provider focalizzato sul contenuto senza le funzionalità dell'editor. Usalo quando non ti serve il visual editor.-
    HTMLProviderProvider per le impostazioni di internazionalizzazione relative all'HTML. Consente la sovrascrittura dei componenti per i tag HTML.-

    Hooks

    Importazione:

    tsx
    import "react-intlayer";
    HookDescrizioneDocumentazione 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(), le 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 lingua corrente, la lingua predefinita, le lingue disponibili e una funzione per aggiornare la lingua.useLocale
    useLocaleBaseHook per ottenere la locale corrente e tutti i campi correlati (locale, defaultLocale, availableLocales, setLocale) dal contesto.-
    usePathnameHook che restituisce il percorso corrente (pathname) con il segmento della lingua rimosso. Reattivo alla navigazione del browser tramite popstate.usePathname
    useRewriteURLHook lato client per gestire le riscritture degli URL. Se esiste una regola di riscrittura per il percorso (pathname) e la lingua correnti, aggiornerà l'URL.useRewriteURL
    useI18nHook che fornisce una funzione di traduzione t() per accedere a contenuti nidificati tramite chiave. Imita il pattern di i18next/next-intl.useI18n
    useIntlHook che fornisce un oggetto Intl legato alla locale. Inietta automaticamente la locale corrente e utilizza caching ottimizzato.-
    useLocaleStorageHook che fornisce la persistenza della locale nel local storage o nei cookie. Restituisce funzioni getter e setter.-
    useLocaleCookieDeprecato. Usa useLocaleStorage invece. Hook che gestisce la persistenza della locale nei cookie.-
    useLoadDynamicHook per caricare dizionari dinamici usando React Suspense. Accetta una chiave e una promise, memorizza i risultati nella cache.-
    useIntlayerContextHook che fornisce i valori del contesto client Intlayer correnti (locale, setLocale, ecc.).-
    useHTMLContextHook per accedere agli override dei componenti HTML dal contesto HTMLProvider.-

    Funzioni

    Importazione:

    tsx
    import "react-intlayer";

    Funzione | Descrizione | Doc correlata

    t | Funzione di traduzione lato client che restituisce la traduzione del contenuto multilingue fornito. Usa la locale dal contesto se non fornita. | traduzione

    getDictionary | Elabora gli oggetti del dizionario e restituisce il contenuto per la locale specificata. Elabora le traduzioni t(), le enumerazioni, il markdown, l'HTML, ecc. | -

    getIntlayer | Recupera un dizionario tramite la sua chiave dalla dichiarazione generata e restituisce il suo contenuto per la locale specificata. Versione ottimizzata di getDictionary. | -

    setLocaleInStorage | Imposta la locale nello storage (local storage o cookie in base alla configurazione). | -

    setLocaleCookie | Deprecato. Usa setLocaleInStorage al suo posto. Imposta la locale in un cookie. | -

    localeInStorage | Recupera la locale dallo storage (local storage o cookie). | -

    localeCookie | Deprecato. Usa localeInStorage invece. Recupera la locale dal cookie. | -

    Componenti

    Importazione:

    tsx
    import "react-intlayer";

    or

    tsx
    import "react-intlayer/markdown";
    ComponenteDescrizioneDocumentazione correlata
    MarkdownProviderProvider per il contesto di rendering del Markdown. Consente override di componenti personalizzati per gli elementi Markdown.-
    MarkdownRendererEsegue il rendering di contenuti Markdown con componenti personalizzati. Supporta tutte le funzionalità standard del Markdown e la sintassi specifica di Intlayer.MarkdownRenderer

    Tipi

    Importazione:

    tsx
    import "react-intlayer";
    TipoDescrizione
    IntlayerNodeTipo che rappresenta un nodo nell'albero dei contenuti di Intlayer. Usato per la manipolazione dei contenuti in modo type-safe.

    Lato server (react-intlayer/server)

    Importazione:

    tsx
    import "react-intlayer/server";
    EsportazioneTipoDescrizione
    IntlayerServerProviderComponentProvider per il rendering lato server.
    IntlayerServerComponentWrapper lato server per i contenuti Intlayer.
    tFunctionVersione lato server della funzione di traduzione.
    useLocaleHookHook per accedere alla locale sul lato server.
    useIntlayerHookVersione lato server di useIntlayer.
    useDictionaryHookVersione lato server di useDictionary.
    useI18nHookVersione lato server di useI18n.
    localeFunctionFunzione per ottenere o impostare la locale sul server.
    validatePrefixIntlayerProvider