Autore:
    Creazione:2026-09-19Ultimo aggiornamento:2026-09-19

    Pacchetto remix-intlayer

    Il pacchetto remix-intlayer fornisce gli strumenti necessari per integrare Intlayer nelle applicazioni Remix 3. Costruito interamente sugli standard web (Request, Response, Headers e URL), offre un middleware di router per il routing basato sulla locale e riscritture interne, archiviazione del contesto, hook e utilità di formattazione per la gestione dei contenuti multilingue.

    Installazione

    bash
    npm install remix-intlayer
    

    Esportazioni

    Middleware

    Importazione:

    tsx
    import { intlayer } from "remix-intlayer";
    
    FunzioneDescrizioneDoc correlata
    intlayerMiddleware del router Remix 3 che gestisce il routing basato sulla locale (reindirizzamenti e riscritture interne), risolve la locale della richiesta, la persiste nei cookie/header e inizializza l'ambito del contesto della richiesta.intlayer

    Contesto

    Importazione:

    tsx
    import { Intlayer, INTLAYER_CONTEXT_PROPERTY } from "remix-intlayer";
    
    EsportazioneTipoDescrizioneDoc correlata
    IntlayerContextKeyChiave di RequestContext contenente l'IntlayerState (locale, defaultLocale, availableLocales) per la richiesta corrente.Intlayer
    INTLAYER_CONTEXT_PROPERTYstringNome della proprietà ('intlayer') installata direttamente sul contesto della richiesta, accessibile tramite context.intlayer e context.get(Intlayer).-

    Hook

    Importazione:

    tsx
    import { useIntlayer, useDictionary, useLocale } from "remix-intlayer";
    
    HookDescrizioneDoc correlata
    useIntlayerSeleziona un dizionario tramite la sua chiave e restituisce il suo contenuto per la locale della richiesta corrente. Legge automaticamente dal contesto della richiesta.useIntlayer
    useDictionaryTrasforma un oggetto dizionario importato e restituisce il suo contenuto per la locale della richiesta corrente. Supporta selettori.useDictionary
    useLocaleRestituisce la locale risolta della richiesta corrente, insieme a defaultLocale e availableLocales configurate.useLocale

    Utilità

    Importazione:

    tsx
    import { createLocaleRouting, getIntlayerState } from "remix-intlayer";
    
    FunzioneDescrizioneDoc correlata
    createLocaleRoutingFunzione pura che determina le azioni di routing (redirect, rewrite o pass) in base a richiesta, configurazione e opzioni.-
    getIntlayerStateLegge l'IntlayerState corrente (locale, defaultLocale, availableLocales) dallo scope AsyncLocalStorage.-

    Formattatori (remix-intlayer/format)

    Importazione:

    tsx
    import {
      useIntl,
      useDate,
      useNumber,
      useCurrency,
      usePercentage,
      useRelativeTime,
      useList,
      useUnit,
      useCompact,
    } from "remix-intlayer/format";
    
    HookDescrizione
    useIntlRestituisce un'istanza Intl associata alla locale della richiesta con funzionalità di caching e sottoscrizione.
    useDateRestituisce una funzione di formattazione della data associata alla locale della richiesta (Intl.DateTimeFormat).
    useNumberRestituisce una funzione di formattazione dei numeri associata alla locale della richiesta (Intl.NumberFormat).
    useCurrencyRestituisce una funzione di formattazione della valuta associata alla locale della richiesta.
    usePercentageRestituisce una funzione di formattazione percentuale associata alla locale della richiesta.
    useRelativeTimeRestituisce una funzione di formattazione del tempo relativo associata alla locale della richiesta (Intl.RelativeTimeFormat).
    useListRestituisce una funzione di formattazione delle liste associata alla locale della richiesta (Intl.ListFormat).
    useUnitRestituisce una funzione di formattazione delle unità associata alla locale della richiesta.
    useCompactRestituisce una funzione di formattazione numerica compatta associata alla locale della richiesta (es. 1.5K).

    Utilità HTML (remix-intlayer/html)

    Importazione:

    tsx
    import { renderHTML, useHTML, useHTMLRenderer } from "remix-intlayer/html";
    
    EsportazioneTipoDescrizione
    renderHTMLFunctionFunzione di utilità per eseguire il rendering di nodi HTML all'esterno dell'interfaccia utente.
    useHTMLHookHook per ottenere il contesto e la configurazione del provider HTML.
    useHTMLRendererHookHook per ottenere una funzione di rendering HTML preconfigurata.

    Utilità Markdown (remix-intlayer/markdown)

    Importazione:

    tsx
    import {
      compileMarkdown,
      renderMarkdown,
      parseMarkdown,
      useMarkdown,
      useMarkdownRenderer,
    } from "remix-intlayer/markdown";
    
    EsportazioneTipoDescrizione
    compileMarkdownFunctionCompila stringhe markdown in una rappresentazione strutturata.
    renderMarkdownFunctionEsegue il rendering del contenuto markdown in nodi di output.
    parseMarkdownFunctionAnalizza il contenuto markdown non elaborato in un AST.
    useMarkdownHookHook per accedere al contesto del provider markdown.
    useMarkdownRendererHookHook per ottenere una funzione di rendering Markdown preconfigurata.

    Tipi

    Importazione:

    tsx
    import type {
      IntlayerState,
      IntlayerMiddlewareOptions,
      LocaleRoutingOptions,
      LocaleRoutingAction,
      LocaleRoutingRequest,
      UseLocaleResult,
    } from "remix-intlayer";
    
    TipoDescrizione
    IntlayerStateOggetto di stato contenente locale, defaultLocale e availableLocales memorizzato nel contesto Remix.
    IntlayerMiddlewareOptionsOpzioni di configurazione passate al middleware intlayer().
    LocaleRoutingOptionsOpzioni che personalizzano i prefissi di locale, il rilevamento e i reindirizzamenti.
    LocaleRoutingActionUnione discriminata che rappresenta la decisione di routing: redirect, rewrite o pass.
    LocaleRoutingRequestRappresentazione minima della richiesta richiesta da createLocaleRouting.
    UseLocaleResultTipo restituito da useLocale(), contenente locale, defaultLocale e availableLocales.