Pose una domanda e ottieni un riassunto del documento facendo riferimento a questa pagina e al provider AI di tua scelta
Cronologia delle versioni
- "Aggiunta documentazione degli hook useIntlayer, useDictionary, useLocale, del middleware e dei formattatori"v9.5.519/09/2026
- "Documentazione unificata per tutte le esportazioni"v8.0.021/01/2026
Il contenuto di questa pagina è stato tradotto con un'IA.
Vedi l'ultima versione del contenuto originale in ingleseSe hai un’idea per migliorare questa documentazione, non esitare a contribuire inviando una pull request su GitHub.
Collegamento GitHub alla documentazioneCopia il Markdown del documento nella porta-documenti
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
Copiare il codice nella clipboard
Esportazioni
Integrazione
Il pacchetto astro-intlayer fornisce un'integrazione Astro che configura Intlayer nel tuo progetto.
Importazione:
Copiare il codice nella clipboard
o importazione predefinita in astro.config.mjs:
Copiare il codice nella clipboard
Apri la tabella in una finestra modale per visualizzare tutti i dati in modo chiaro
| Funzione | Descrizione | Documentazione correlata |
|---|---|---|
intlayer | Integrazione 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:
Copiare il codice nella clipboard
Apri la tabella in una finestra modale per visualizzare tutti i dati in modo chiaro
| Hook | Descrizione | Documentazione correlata |
|---|---|---|
useIntlayer | Seleziona 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 |
useDictionary | Trasforma un oggetto dizionario e restituisce il contenuto per il locale risolto. Funziona nel frontmatter e negli script client. | useDictionary |
useLocale | Restituisce il locale corrente, il locale predefinito, i locale disponibili e una funzione per aggiornare il locale. | useLocale |
Middleware (astro-intlayer/middleware)
Importazione:
Copiare il codice nella clipboard
Apri la tabella in una finestra modale per visualizzare tutti i dati in modo chiaro
| Esportazione | Tipo | Descrizione | Documentazione correlata |
|---|---|---|---|
onRequest | MiddlewareHandler | Middleware 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:
Copiare il codice nella clipboard
Apri la tabella in una finestra modale per visualizzare tutti i dati in modo chiaro
| Funzione | Descrizione | Documentazione correlata |
|---|---|---|
getIntlayerLocals | Funzione helper per recuperare l'oggetto IntlayerLocals corrente dall'ambito di archiviazione della richiesta fuori da Astro.locals. | - |
Utilità Client (astro-intlayer/client)
Importazione:
Copiare il codice nella clipboard
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:
Copiare il codice nella clipboard
Apri la tabella in una finestra modale per visualizzare tutti i dati in modo chiaro
| Hook | Descrizione |
|---|---|
useIntl | Restituisce un'istanza Intl associata al locale con funzionalità di memorizzazione nella cache e iscrizione. |
useDate | Restituisce una funzione di formattazione della data associata al locale corrente (Intl.DateTimeFormat). |
useNumber | Restituisce una funzione di formattazione numerica associata al locale corrente (Intl.NumberFormat). |
useCurrency | Restituisce una funzione di formattazione della valuta associata al locale corrente. |
usePercentage | Restituisce una funzione di formattazione della percentuale associata al locale corrente. |
useRelativeTime | Restituisce una funzione di formattazione del tempo relativo associata al locale corrente (Intl.RelativeTimeFormat). |
useList | Restituisce una funzione di formattazione di elenchi associata al locale corrente (Intl.ListFormat). |
useUnit | Restituisce una funzione di formattazione delle unità associata al locale corrente. |
useCompact | Restituisce una funzione di formattazione numerica compatta associata al locale corrente (es. 1.5K). |
Utilità HTML (astro-intlayer/html)
Importazione:
Copiare il codice nella clipboard
Apri la tabella in una finestra modale per visualizzare tutti i dati in modo chiaro
| Esportazione | Tipo | Descrizione |
|---|---|---|
renderHTML | Function | Funzione di utilità autonoma per il rendering dei nodi HTML. |
useHTML | Hook | Hook per ottenere il contesto e la configurazione del provider HTML. |
useHTMLRenderer | Hook | Hook per ottenere una funzione di rendering HTML preconfigurata. |
Utilità Markdown (astro-intlayer/markdown)
Importazione:
Copiare il codice nella clipboard
Apri la tabella in una finestra modale per visualizzare tutti i dati in modo chiaro
| Esportazione | Tipo | Descrizione |
|---|---|---|
compileMarkdown | Function | Compila stringhe markdown in una rappresentazione strutturata. |
renderMarkdown | Function | Renderizza il contenuto markdown in nodi di output. |
parseMarkdown | Function | Analizza il contenuto markdown non elaborato in un AST. |
useMarkdown | Hook | Hook per ottenere il contesto del provider markdown. |
useMarkdownRenderer | Hook | Hook per ottenere una funzione di rendering Markdown preconfigurata. |
Tipi
Importazione:
Copiare il codice nella clipboard
Apri la tabella in una finestra modale per visualizzare tutti i dati in modo chiaro
| Tipo | Descrizione |
|---|---|
IntlayerLocals | L'oggetto allegato a Astro.locals.intlayer contenente locale, defaultLocale e availableLocales. |
UseLocaleProps | Proprietà di configurazione opzionali accettate da useLocale(). |
UseLocaleResult | Il tipo restituito da useLocale(), che fornisce proprietà del locale e metodi di aggiornamento. |
