著者:
    作成:2026-01-21最終更新:2026-09-19

    astro-intlayer パッケージ

    astro-intlayer パッケージは、Intlayer を Astro アプリケーションに統合するために必要なツールを提供します。ロケールベースのルーティング、辞書管理、ビルド時のページ書き換え、リクエストミドルウェア、およびサーバーレンダリングされた .astro コンポーネントとクライアント側スクリプトの両方で多言語コンテンツにアクセスするためのフックを設定します。

    インストール

    bash
    npm install astro-intlayer
    

    エクスポート

    統合

    astro-intlayer パッケージは、プロジェクトに Intlayer を設定する Astro 統合を提供します。

    インポート:

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

    または astro.config.mjs でのデフォルトインポート:

    ts
    import { defineConfig } from "astro/config";
    import intlayer from "astro-intlayer";
    
    export default defineConfig({
      integrations: [intlayer()],
    });
    
    関数説明関連ドキュメント
    intlayer辞書を準備し、Vite プラグイン(エイリアス、ルーティングプロキシ、プルーニング)を設定し、リクエストミドルウェアを自動登録し、ローカライズされた URL でプリレンダリングページを出力する Astro 統合。intlayer

    フック(サーバーおよびクライアント)

    インポート:

    tsx
    import { useIntlayer, useDictionary, useLocale } from "astro-intlayer";
    
    フック説明関連ドキュメント
    useIntlayerキーによって辞書を1つ選択し、そのローカライズされたコンテンツを返します。.astro のフロントマターでは Astro.locals からリクエストロケールを読み取り、<script> ではクライアントストアから読み取ります。useIntlayer
    useDictionary辞書オブジェクトを変換し、解決されたロケールのコンテンツを返します。フロントマターおよびクライアントスクリプトで動作します。useDictionary
    useLocale現在のロケール、デフォルトロケール、利用可能なロケール一覧、およびロケール更新関数を返します。useLocale

    ミドルウェア (astro-intlayer/middleware)

    インポート:

    tsx
    import { onRequest } from "astro-intlayer/middleware";
    
    エクスポートタイプ説明関連ドキュメント
    onRequestMiddlewareHandlerリクエストロケールを検出し Astro.locals.intlayer をアタッチする Astro ミドルウェア。intlayer() によって自動登録されるか、手動で合成するためにインポートします。onRequest

    ユーティリティ

    インポート:

    tsx
    import { getIntlayerLocals } from "astro-intlayer";
    
    関数説明関連ドキュメント
    getIntlayerLocalsAstro.locals の外部でリクエストストレージスコープから現在の IntlayerLocals オブジェクトを取得するヘルパー関数。-

    クライアントユーティリティ (astro-intlayer/client)

    インポート:

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

    ブラウザまたはクライアントの <script> タグ内でインポートされると、astro-intlayer は自動的に astro-intlayer/clientvanilla-intlayer 提供)にマップされ、クライアント側の辞書ゲッター、ストア購読、およびロケール永続化ツールを提供します。

    フォーマッター (astro-intlayer/format)

    インポート:

    tsx
    import {
      useIntl,
      useDate,
      useNumber,
      useCurrency,
      usePercentage,
      useRelativeTime,
      useList,
      useUnit,
      useCompact,
    } from "astro-intlayer/format";
    
    フック説明
    useIntlキャッシュおよび購読機能を備えた、リクエストまたはクライアントロケールにバインドされた Intl インスタンスを返します。
    useDate現在のロケールにバインドされた日付フォーマット関数を返します (Intl.DateTimeFormat)。
    useNumber現在のロケールにバインドされた数値フォーマット関数を返します (Intl.NumberFormat)。
    useCurrency現在のロケールにバインドされた通貨フォーマット関数を返します。
    usePercentage現在のロケールにバインドされたパーセンテージフォーマット関数を返します。
    useRelativeTime現在のロケールにバインドされた相対時間フォーマット関数を返します (Intl.RelativeTimeFormat)。
    useList現在のロケールにバインドされたリストフォーマット関数を返します (Intl.ListFormat)。
    useUnit現在のロケールにバインドされた単位フォーマット関数を返します。
    useCompact現在のロケールにバインドされたコンパクト数値フォーマット関数を返します(例: 1.5K)。

    HTML ユーティリティ (astro-intlayer/html)

    インポート:

    tsx
    import { renderHTML, useHTML, useHTMLRenderer } from "astro-intlayer/html";
    
    エクスポートタイプ説明
    renderHTMLFunctionHTML ノードをレンダリングするスタンドアロンユーティリティ関数。
    useHTMLHookHTML プロバイダーコンテキストと設定を取得するフック。
    useHTMLRendererHook事前設定された HTML レンダラー関数を取得するフック。

    Markdown ユーティリティ (astro-intlayer/markdown)

    インポート:

    tsx
    import {
      compileMarkdown,
      renderMarkdown,
      parseMarkdown,
      useMarkdown,
      useMarkdownRenderer,
    } from "astro-intlayer/markdown";
    
    エクスポートタイプ説明
    compileMarkdownFunctionMarkdown 文字列を構造化表現にコンパイルします。
    renderMarkdownFunctionMarkdown コンテンツを出力ノードにレンダリングします。
    parseMarkdownFunction生の Markdown コンテンツを AST に解析します。
    useMarkdownHookMarkdown プロバイダーコンテキストを取得するフック。
    useMarkdownRendererHook事前設定された Markdown レンダラー関数を取得するフック。

    タイプ

    インポート:

    tsx
    import type {
      IntlayerLocals,
      UseLocaleProps,
      UseLocaleResult,
    } from "astro-intlayer";
    
    タイプ説明
    IntlayerLocalslocaledefaultLocale、および availableLocales を含む Astro.locals.intlayer にアタッチされたオブジェクト。
    UseLocalePropsuseLocale() が受け入れるオプションの設定プロパティ。
    UseLocaleResultロケールプロパティと更新メソッドを提供する useLocale() の戻り値の型。