Autor:
    Aymeric PINEAU
    Erstellung:2026-01-21Letzte Aktualisierung:2026-09-19

    astro-intlayer Paket

    Das Paket astro-intlayer bietet die erforderlichen Werkzeuge zur Integration von Intlayer in Astro-Anwendungen. Es konfiguriert locale-basiertes Routing, Wörterbuchverwaltung, Seiten-Umschreiben während des Builds, Request-Middleware und Hooks für den Zugriff auf mehrsprachige Inhalte in serverseitig gerenderten .astro-Komponenten und clientseitigen Skripten.

    Installation

    bash
    npm install astro-intlayer

    Exporte

    Integration

    Das Paket astro-intlayer bietet eine Astro-Integration, die Intlayer in Ihrem Projekt einrichtet.

    Import:

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

    oder Standard-Import in astro.config.mjs:

    ts
    import { defineConfig } from "astro/config";
import intlayer from "astro-intlayer";

export default defineConfig({
  integrations: [intlayer()],
});
    FunktionBeschreibungZugehörige Dokumentation
    intlayerAstro-Integration, die Wörterbücher vorbereitet, Vite-Plugins konfiguriert (Aliase, Routing-Proxy, Bereinigung), Request-Middleware automatisch registriert und vorgerenderte Seiten an umgeschriebenen URLs ausgibt.intlayer

    Hooks (Server und Client)

    Import:

    tsx
    import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
    HookBeschreibungZugehörige Dokumentation
    useIntlayerWählt ein Wörterbuch anhand seines Schlüssels aus und gibt dessen lokalisierten Inhalt zurück. Im .astro-Frontmatter liest es das Anfrage-Locale aus Astro.locals. Im <script> aus dem Client-Store.useIntlayer
    useDictionaryTransformiert ein Wörterbuchobjekt und gibt den Inhalt für das aufgelöste Locale zurück. Funktioniert im Frontmatter und in Client-Skripten.useDictionary
    useLocaleGibt das aktuelle Locale, das Standard-Locale, die verfügbaren Locales und eine Funktion zum Aktualisieren des Locales zurück.useLocale

    Middleware (astro-intlayer/middleware)

    Import:

    tsx
    import { onRequest } from "astro-intlayer/middleware";
    ExportTypBeschreibungZugehörige Dokumentation
    onRequestMiddlewareHandlerAstro-Middleware, die das Anfrage-Locale erkennt und Astro.locals.intlayer anhängt. Wird automatisch von intlayer() registriert oder manuell zur Komposition importiert.onRequest

    Dienstprogramme

    Import:

    tsx
    import { getIntlayerLocals } from "astro-intlayer";
    FunktionBeschreibungZugehörige Dokumentation
    getIntlayerLocalsHilfsfunktion zum Abrufen des aktuellen IntlayerLocals-Objekts aus dem Request-Speicherbereich außerhalb von Astro.locals.-

    Client-Dienstprogramme (astro-intlayer/client)

    Import:

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

    Beim Import im Browser oder in Client-<script>-Tags verweist astro-intlayer automatisch auf astro-intlayer/client (bereitgestellt von vanilla-intlayer), was clientseitige Wörterbuch-Getter, Store-Abonnenten und Locale-Persistenz-Werkzeuge bereitstellt.

    Formatierer (astro-intlayer/format)

    Import:

    tsx
    import {
  useIntl,
  useDate,
  useNumber,
  useCurrency,
  usePercentage,
  useRelativeTime,
  useList,
  useUnit,
  useCompact,
} from "astro-intlayer/format";
    HookBeschreibung
    useIntlGibt eine Intl-Instanz gebunden an das Locale zurück mit Caching- und Abonnementfunktionen.
    useDateGibt eine Datumsformatierungsfunktion gebunden an das aktuelle Locale zurück (Intl.DateTimeFormat).
    useNumberGibt eine Zahlenformatierungsfunktion gebunden an das aktuelle Locale zurück (Intl.NumberFormat).
    useCurrencyGibt eine Währungsformatierungsfunktion gebunden an das aktuelle Locale zurück.
    usePercentageGibt eine Prozentformatierungsfunktion gebunden an das aktuelle Locale zurück.
    useRelativeTimeGibt eine relative Zeitformatierungsfunktion gebunden an das aktuelle Locale zurück (Intl.RelativeTimeFormat).
    useListGibt eine Listenformatierungsfunktion gebunden an das aktuelle Locale zurück (Intl.ListFormat).
    useUnitGibt eine Einheitenformatierungsfunktion gebunden an das aktuelle Locale zurück.
    useCompactGibt eine kompakte Zahlenformatierungsfunktion gebunden an das aktuelle Locale zurück (z. B. 1.5K).

    HTML-Dienstprogramme (astro-intlayer/html)

    Import:

    tsx
    import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
    ExportTypBeschreibung
    renderHTMLFunctionEigenständige Hilfsfunktion zum Rendern von HTML-Knoten.
    useHTMLHookHook zum Abrufen des HTML-Provider-Kontexts und der Konfiguration.
    useHTMLRendererHookHook zum Abrufen einer vorkonfigurierten HTML-Renderer-Funktion.

    Markdown-Dienstprogramme (astro-intlayer/markdown)

    Import:

    tsx
    import {
  compileMarkdown,
  renderMarkdown,
  parseMarkdown,
  useMarkdown,
  useMarkdownRenderer,
} from "astro-intlayer/markdown";
    ExportTypBeschreibung
    compileMarkdownFunctionKompiliert Markdown-Zeichenfolgen in eine strukturierte Darstellung.
    renderMarkdownFunctionRendert Markdown-Inhalt in Ausgabeknoten.
    parseMarkdownFunctionAnalysiert rohen Markdown-Inhalt in einen AST.
    useMarkdownHookHook zum Abrufen des Markdown-Provider-Kontexts.
    useMarkdownRendererHookHook zum Abrufen einer vorkonfigurierten Markdown-Renderer-Funktion.

    Typen

    Import:

    tsx
    import type {
  IntlayerLocals,
  UseLocaleProps,
  UseLocaleResult,
} from "astro-intlayer";
    TypBeschreibung
    IntlayerLocalsDas an Astro.locals.intlayer angehängte Objekt mit locale, defaultLocale und availableLocales.
    UseLocalePropsOptionale Konfigurationseigenschaften, die von useLocale() akzeptiert werden.
    UseLocaleResultDer Rückgabetyp von useLocale(), der Locale-Eigenschaften und Aktualisierungsmethoden bereitstellt.
    lynx-intlayerintlayer