Haz tu pregunta y obtén un resumen del documento referenciando esta página y el proveedor AI de tu elección
Historial de versiones
- "Añadida documentación de hooks useIntlayer, useDictionary, useLocale, middleware y formateadores"v9.5.519/9/2026
- "Documentación unificada para todas las exportaciones"v8.0.021/1/2026
El contenido de esta página ha sido traducido con una IA.
Ver la última versión del contenido original en inglésSi tienes una idea para mejorar esta documentación, no dudes en contribuir enviando una pull request en GitHub.
Enlace de GitHub a la documentaciónCopiar el Markdown del documento a la portapapeles
Paquete astro-intlayer
El paquete astro-intlayer proporciona las herramientas necesarias para integrar Intlayer en aplicaciones Astro. Configura el enrutamiento basado en locales, la gestión de diccionarios, la reescritura de páginas en tiempo de compilación, el middleware de solicitudes y los hooks para acceder al contenido multilingüe tanto en componentes .astro renderizados en el servidor como en scripts del lado del cliente.
Instalación
Copiar el código al portapapeles
Exportaciones
Integración
El paquete astro-intlayer proporciona una integración de Astro que configura Intlayer en tu proyecto.
Importación:
Copiar el código al portapapeles
o importación por defecto en astro.config.mjs:
Copiar el código al portapapeles
Abrir la tabla en una ventana flotante para ver todo el contenido claramente
| Función | Descripción | Documentación relacionada |
|---|---|---|
intlayer | Integración de Astro que prepara diccionarios, configura plugins de Vite (alias, proxy de enrutamiento, poda), registra automáticamente el middleware de solicitudes y emite páginas prerenderizadas en URL reescritas. | intlayer |
Hooks (Servidor y Cliente)
Importación:
Copiar el código al portapapeles
Abrir la tabla en una ventana flotante para ver todo el contenido claramente
| Hook | Descripción | Documentación relacionada |
|---|---|---|
useIntlayer | Selecciona un diccionario por su clave y devuelve su contenido localizado. En el frontmatter de .astro, lee el locale de la solicitud de Astro.locals. En <script>, lee desde el store del cliente. | useIntlayer |
useDictionary | Transforma un objeto diccionario y devuelve contenido para el locale resuelto. Funciona en frontmatter y scripts de cliente. | useDictionary |
useLocale | Devuelve el locale actual, el locale predeterminado, los locales disponibles y una función para actualizar el locale. | useLocale |
Middleware (astro-intlayer/middleware)
Importación:
Copiar el código al portapapeles
Abrir la tabla en una ventana flotante para ver todo el contenido claramente
| Exportación | Tipo | Descripción | Documentación relacionada |
|---|---|---|---|
onRequest | MiddlewareHandler | Middleware de Astro que detecta el locale de la solicitud y adjunta Astro.locals.intlayer. Registrado automáticamente por intlayer(), o importado manualmente para su composición. | onRequest |
Utilidades
Importación:
Copiar el código al portapapeles
Abrir la tabla en una ventana flotante para ver todo el contenido claramente
| Función | Descripción | Documentación relacionada |
|---|---|---|
getIntlayerLocals | Función de ayuda para recuperar el objeto IntlayerLocals actual del ámbito de almacenamiento fuera de Astro.locals. | - |
Utilidades de Cliente (astro-intlayer/client)
Importación:
Copiar el código al portapapeles
Cuando se importa en el navegador o dentro de etiquetas <script> del cliente, astro-intlayer se asigna automáticamente a astro-intlayer/client (impulsado por vanilla-intlayer), proporcionando getters de diccionario en el cliente, suscriptores al store y herramientas de persistencia de locale.
Formateadores (astro-intlayer/format)
Importación:
Copiar el código al portapapeles
Abrir la tabla en una ventana flotante para ver todo el contenido claramente
| Hook | Descripción |
|---|---|
useIntl | Devuelve una instancia de Intl vinculada al locale con capacidades de almacenamiento en caché y suscripción. |
useDate | Devuelve una función de formato de fecha predeterminada para el locale actual (Intl.DateTimeFormat). |
useNumber | Devuelve una función de formato numérico predeterminada para el locale actual (Intl.NumberFormat). |
useCurrency | Devuelve una función de formato de moneda predeterminada para el locale actual. |
usePercentage | Devuelve una función de formato de porcentaje predeterminada para el locale actual. |
useRelativeTime | Devuelve una función de formato de tiempo relativo predeterminada para el locale actual (Intl.RelativeTimeFormat). |
useList | Devuelve una función de formato de lista predeterminada para el locale actual (Intl.ListFormat). |
useUnit | Devuelve una función de formato de unidad predeterminada para el locale actual. |
useCompact | Devuelve una función de formato de número compacto predeterminada para el locale actual (p. ej. 1.5K). |
Utilidades HTML (astro-intlayer/html)
Importación:
Copiar el código al portapapeles
Abrir la tabla en una ventana flotante para ver todo el contenido claramente
| Exportación | Tipo | Descripción |
|---|---|---|
renderHTML | Function | Función de utilidad independiente para renderizar nodos HTML. |
useHTML | Hook | Hook para obtener el contexto y configuración del proveedor de HTML. |
useHTMLRenderer | Hook | Hook para obtener una función de renderizado de HTML preconfigurada. |
Utilidades Markdown (astro-intlayer/markdown)
Importación:
Copiar el código al portapapeles
Abrir la tabla en una ventana flotante para ver todo el contenido claramente
| Exportación | Tipo | Descripción |
|---|---|---|
compileMarkdown | Function | Compila cadenas markdown en una representación estructurada. |
renderMarkdown | Function | Renderiza contenido markdown en nodos de salida. |
parseMarkdown | Function | Analiza contenido markdown en un AST. |
useMarkdown | Hook | Hook para obtener el contexto del proveedor de markdown. |
useMarkdownRenderer | Hook | Hook para obtener una función de renderizado de Markdown preconfigurada. |
Tipos
Importación:
Copiar el código al portapapeles
Abrir la tabla en una ventana flotante para ver todo el contenido claramente
| Tipo | Descripción |
|---|---|
IntlayerLocals | El objeto adjunto a Astro.locals.intlayer que contiene locale, defaultLocale y availableLocales. |
UseLocaleProps | Propiedades de configuración opcionales aceptadas por useLocale(). |
UseLocaleResult | El tipo de retorno de useLocale(), que proporciona propiedades de locale y métodos de actualización. |
