Autor:
    Creación:2026-01-21Última actualización:2026-09-19

    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

    bash
    npm install astro-intlayer
    

    Exportaciones

    Integración

    El paquete astro-intlayer proporciona una integración de Astro que configura Intlayer en tu proyecto.

    Importación:

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

    o importación por defecto en astro.config.mjs:

    ts
    import { defineConfig } from "astro/config";
    import intlayer from "astro-intlayer";
    
    export default defineConfig({
      integrations: [intlayer()],
    });
    
    FunciónDescripciónDocumentación relacionada
    intlayerIntegració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:

    tsx
    import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
    
    HookDescripciónDocumentación relacionada
    useIntlayerSelecciona 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
    useDictionaryTransforma un objeto diccionario y devuelve contenido para el locale resuelto. Funciona en frontmatter y scripts de cliente.useDictionary
    useLocaleDevuelve el locale actual, el locale predeterminado, los locales disponibles y una función para actualizar el locale.useLocale

    Middleware (astro-intlayer/middleware)

    Importación:

    tsx
    import { onRequest } from "astro-intlayer/middleware";
    
    ExportaciónTipoDescripciónDocumentación relacionada
    onRequestMiddlewareHandlerMiddleware 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:

    tsx
    import { getIntlayerLocals } from "astro-intlayer";
    
    FunciónDescripciónDocumentación relacionada
    getIntlayerLocalsFunció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:

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

    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:

    tsx
    import {
      useIntl,
      useDate,
      useNumber,
      useCurrency,
      usePercentage,
      useRelativeTime,
      useList,
      useUnit,
      useCompact,
    } from "astro-intlayer/format";
    
    HookDescripción
    useIntlDevuelve una instancia de Intl vinculada al locale con capacidades de almacenamiento en caché y suscripción.
    useDateDevuelve una función de formato de fecha predeterminada para el locale actual (Intl.DateTimeFormat).
    useNumberDevuelve una función de formato numérico predeterminada para el locale actual (Intl.NumberFormat).
    useCurrencyDevuelve una función de formato de moneda predeterminada para el locale actual.
    usePercentageDevuelve una función de formato de porcentaje predeterminada para el locale actual.
    useRelativeTimeDevuelve una función de formato de tiempo relativo predeterminada para el locale actual (Intl.RelativeTimeFormat).
    useListDevuelve una función de formato de lista predeterminada para el locale actual (Intl.ListFormat).
    useUnitDevuelve una función de formato de unidad predeterminada para el locale actual.
    useCompactDevuelve 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:

    tsx
    import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
    
    ExportaciónTipoDescripción
    renderHTMLFunctionFunción de utilidad independiente para renderizar nodos HTML.
    useHTMLHookHook para obtener el contexto y configuración del proveedor de HTML.
    useHTMLRendererHookHook para obtener una función de renderizado de HTML preconfigurada.

    Utilidades Markdown (astro-intlayer/markdown)

    Importación:

    tsx
    import {
      compileMarkdown,
      renderMarkdown,
      parseMarkdown,
      useMarkdown,
      useMarkdownRenderer,
    } from "astro-intlayer/markdown";
    
    ExportaciónTipoDescripción
    compileMarkdownFunctionCompila cadenas markdown en una representación estructurada.
    renderMarkdownFunctionRenderiza contenido markdown en nodos de salida.
    parseMarkdownFunctionAnaliza contenido markdown en un AST.
    useMarkdownHookHook para obtener el contexto del proveedor de markdown.
    useMarkdownRendererHookHook para obtener una función de renderizado de Markdown preconfigurada.

    Tipos

    Importación:

    tsx
    import type {
      IntlayerLocals,
      UseLocaleProps,
      UseLocaleResult,
    } from "astro-intlayer";
    
    TipoDescripción
    IntlayerLocalsEl objeto adjunto a Astro.locals.intlayer que contiene locale, defaultLocale y availableLocales.
    UseLocalePropsPropiedades de configuración opcionales aceptadas por useLocale().
    UseLocaleResultEl tipo de retorno de useLocale(), que proporciona propiedades de locale y métodos de actualización.