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

    Pacchetto astro-intlayer

    Il pacchetto astro-intlayer fornisce gli strumenti necessari per integrare Intlayer nelle applicazioni Astro. Configura il routing basato su locale, la gestione dei dizionari, la riscrittura delle pagine in fase di compilazione, il middleware di richiesta e gli hook per accedere a contenuti multilingue sia nei componenti .astro renderizzati dal server sia negli script lato client.

    Installazione

    bash
    npm install astro-intlayer
    

    Esportazioni

    Integrazione

    Il pacchetto astro-intlayer fornisce un'integrazione Astro che configura Intlayer nel tuo progetto.

    Importazione:

    tsx
    import { intlayer } from "astro-intlayer";
    

    o importazione predefinita in astro.config.mjs:

    ts
    import { defineConfig } from "astro/config";
    import intlayer from "astro-intlayer";
    
    export default defineConfig({
      integrations: [intlayer()],
    });
    
    FunzioneDescrizioneDocumentazione correlata
    intlayerIntegrazione Astro che prepara i dizionari, configura i plugin Vite (alias, proxy di routing, eliminazione), registra automaticamente il middleware di richiesta ed emette pagine pre-renderizzate su URL riscritti.intlayer

    Hook (Server e Client)

    Importazione:

    tsx
    import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
    
    HookDescrizioneDocumentazione correlata
    useIntlayerSeleziona un dizionario tramite la sua chiave e restituisce il suo contenuto localizzato. Nel frontmatter .astro, legge il locale di richiesta da Astro.locals. In <script>, legge dallo store client.useIntlayer
    useDictionaryTrasforma un oggetto dizionario e restituisce il contenuto per il locale risolto. Funziona nel frontmatter e negli script client.useDictionary
    useLocaleRestituisce il locale corrente, il locale predefinito, i locale disponibili e una funzione per aggiornare il locale.useLocale

    Middleware (astro-intlayer/middleware)

    Importazione:

    tsx
    import { onRequest } from "astro-intlayer/middleware";
    
    EsportazioneTipoDescrizioneDocumentazione correlata
    onRequestMiddlewareHandlerMiddleware Astro che rileva il locale della richiesta e allega Astro.locals.intlayer. Registrato automaticamente da intlayer(), o importato manualmente per essere composto.onRequest

    Utilità

    Importazione:

    tsx
    import { getIntlayerLocals } from "astro-intlayer";
    
    FunzioneDescrizioneDocumentazione correlata
    getIntlayerLocalsFunzione helper per recuperare l'oggetto IntlayerLocals corrente dall'ambito di archiviazione della richiesta fuori da Astro.locals.-

    Utilità Client (astro-intlayer/client)

    Importazione:

    tsx
    import {
      useIntlayer,
      useDictionary,
      useDictionaryDynamic,
      useLocale,
      useLocaleStorage,
      useLocaleCookie,
      getIntlayer,
      getDictionary,
      installIntlayer,
      setLocaleInStorage,
      setLocaleCookie,
      localeInStorage,
      localeCookie,
    } from "astro-intlayer/client";
    

    Quando importato nel browser o all'interno dei tag client <script>, astro-intlayer si mappa automaticamente su astro-intlayer/client (alimentato da vanilla-intlayer), fornendo getter di dizionario lato client, sottoscrittori dello store e strumenti di persistenza del locale.

    Formattatori (astro-intlayer/format)

    Importazione:

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

    Utilità HTML (astro-intlayer/html)

    Importazione:

    tsx
    import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
    
    EsportazioneTipoDescrizione
    renderHTMLFunctionFunzione di utilità autonoma per il rendering dei nodi HTML.
    useHTMLHookHook per ottenere il contesto e la configurazione del provider HTML.
    useHTMLRendererHookHook per ottenere una funzione di rendering HTML preconfigurata.

    Utilità Markdown (astro-intlayer/markdown)

    Importazione:

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

    Tipi

    Importazione:

    tsx
    import type {
      IntlayerLocals,
      UseLocaleProps,
      UseLocaleResult,
    } from "astro-intlayer";
    
    TipoDescrizione
    IntlayerLocalsL'oggetto allegato a Astro.locals.intlayer contenente locale, defaultLocale e availableLocales.
    UseLocalePropsProprietà di configurazione opzionali accettate da useLocale().
    UseLocaleResultIl tipo restituito da useLocale(), che fornisce proprietà del locale e metodi di aggiornamento.