Faça sua pergunta e obtenha um resumo do documento referenciando esta página e o provedor AI de sua escolha
Histórico de versões
- "Adicionada documentação dos hooks useIntlayer, useDictionary, useLocale, do middleware e dos formatadores"v9.5.519/09/2026
- "Documentação unificada para todas as exportações"v8.0.021/01/2026
O conteúdo desta página foi traduzido com uma IA.
Veja a última versão do conteúdo original em inglêsSe você tiver uma ideia para melhorar esta documentação, sinta-se à vontade para contribuir enviando uma pull request no GitHub.
Link do GitHub para a documentaçãoCopiar o Markdown do documento para a área de transferência
Pacote astro-intlayer
O pacote astro-intlayer fornece as ferramentas necessárias para integrar o Intlayer em aplicações Astro. Ele configura o roteamento baseado em locale, gerenciamento de dicionários, reescrita de páginas no momento da compilação, middleware de requisição e hooks para acessar conteúdo multilíngue tanto em componentes .astro renderizados no servidor quanto em scripts do lado do cliente.
Instalação
Copiar o código para a área de transferência
Exportações
Integração
O pacote astro-intlayer fornece uma integração Astro que configura o Intlayer no seu projeto.
Importação:
Copiar o código para a área de transferência
ou importação padrão em astro.config.mjs:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Função | Descrição | Documentação relacionada |
|---|---|---|
intlayer | Integração Astro que prepara dicionários, configura plugins Vite (aliases, proxy de roteamento, poda), registra automaticamente middleware de requisição e emite páginas pré-renderizadas em URLs reescritas. | intlayer |
Hooks (Servidor e Cliente)
Importação:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Hook | Descrição | Documentação relacionada |
|---|---|---|
useIntlayer | Seleciona um dicionário por sua chave e retorna seu conteúdo localizado. No frontmatter .astro, lê o locale da requisição de Astro.locals. Em <script>, lê da store do cliente. | useIntlayer |
useDictionary | Transforma um objeto dicionário e retorna conteúdo para o locale resolvido. Funciona no frontmatter e em scripts do cliente. | useDictionary |
useLocale | Retorna o locale atual, o locale padrão, os locales disponíveis e uma função para atualizar o locale. | useLocale |
Middleware (astro-intlayer/middleware)
Importação:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Exportação | Tipo | Descrição | Documentação relacionada |
|---|---|---|---|
onRequest | MiddlewareHandler | Middleware Astro que detecta o locale da requisição e anexa Astro.locals.intlayer. Registrado automaticamente por intlayer(), ou importado manualmente para compor. | onRequest |
Utilitários
Importação:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Função | Descrição | Documentação relacionada |
|---|---|---|
getIntlayerLocals | Função auxiliar para recuperar o objeto IntlayerLocals atual do escopo de armazenamento da requisição fora de Astro.locals. | - |
Utilitários de Cliente (astro-intlayer/client)
Importação:
Copiar o código para a área de transferência
Quando importado no navegador ou dentro de tags <script> do cliente, astro-intlayer mapeia automaticamente para astro-intlayer/client (alimentado por vanilla-intlayer), fornecendo getters de dicionário do lado do cliente, assinantes da store e ferramentas de persistência de locale.
Formatadores (astro-intlayer/format)
Importação:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Hook | Descrição |
|---|---|
useIntl | Retorna uma instância Intl vinculada ao locale com recursos de cache e assinatura. |
useDate | Retorna uma função de formatação de data vinculada ao locale atual (Intl.DateTimeFormat). |
useNumber | Retorna uma função de formatação de número vinculada ao locale atual (Intl.NumberFormat). |
useCurrency | Retorna uma função de formatação de moeda vinculada ao locale atual. |
usePercentage | Retorna uma função de formatação de porcentagem vinculada ao locale atual. |
useRelativeTime | Retorna uma função de formatação de tempo relativo vinculada ao locale atual (Intl.RelativeTimeFormat). |
useList | Retorna uma função de formatação de lista vinculada ao locale atual (Intl.ListFormat). |
useUnit | Retorna uma função de formatação de unidade vinculada ao locale atual. |
useCompact | Retorna uma função de formatação de número compacto vinculada ao locale atual (ex.: 1.5K). |
Utilitários HTML (astro-intlayer/html)
Importação:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Exportação | Tipo | Descrição |
|---|---|---|
renderHTML | Function | Função utilitária independente para renderizar nós HTML. |
useHTML | Hook | Hook para obter o contexto e configuração do provedor HTML. |
useHTMLRenderer | Hook | Hook para obter uma função de renderização HTML pré-configurada. |
Utilitários Markdown (astro-intlayer/markdown)
Importação:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Exportação | Tipo | Descrição |
|---|---|---|
compileMarkdown | Function | Compila strings markdown em uma representação estruturada. |
renderMarkdown | Function | Renderiza conteúdo markdown em nós de saída. |
parseMarkdown | Function | Analisa conteúdo markdown bruto em uma AST. |
useMarkdown | Hook | Hook para obter o contexto do provedor markdown. |
useMarkdownRenderer | Hook | Hook para obter uma função de renderização Markdown pré-configurada. |
Tipos
Importação:
Copiar o código para a área de transferência
Abrir a tabela em um modal para ver todo o conteúdo claramente
| Tipo | Descrição |
|---|---|
IntlayerLocals | O objeto anexado a Astro.locals.intlayer contendo locale, defaultLocale e availableLocales. |
UseLocaleProps | Propriedades de configuração opcionais aceitas por useLocale(). |
UseLocaleResult | O tipo de retorno de useLocale(), fornecendo propriedades de locale e métodos de atualização. |
