著者:
    作成:2026-06-12最終更新:2026-06-26

    動的辞書

    Intlayer は、キーごとの単一の静的辞書を超えるコンテンツを表現するための 2 つのメカニズムをサポートします。それぞれはコンテンツファイル内のトップレベルのメタデータフィールドで宣言され、ラッパー関数は不要です。

    機能 メタデータフィールド useIntlayer のセレクター
    コレクション item: N { item: N }
    バリアント variant: "name" または variant: { … } { variant: "name" } または { variant: { … } }

    いずれも locale 引数と組み合わせられ、importMode による選択的 / 遅延読み込みをサポートします。

    どちらをいつ使うか

    • コレクション — 別々のファイルで管理される順序付きの項目リスト(FAQ 項目、ブログ記事、商品)。
    • バリアント — 名前付きまたは構造化されたコンテンツの代替:
      • A/B テスト、季節バナー、フィーチャーフラグ向けの文字列バリアント。
      • CMS レコード、ユーザー固有のコピー、またはフィールドの集合でアドレス指定される任意のコンテンツ向けのオブジェクトバリアント(旧「動的レコード」)。
    以前のバージョンでは、レコードキー付きコンテンツ用に別個の meta フィールドを公開していました。これは variant に統合されました。meta を使う代わりに variantオブジェクトを渡してください。

    セレクターの曖昧性解消

    キーは両方の次元を同時に宣言できます(例: 各項目にバリアントを持つコレクション)。これらは次の順序で解決されます:

    plaintext
    variant → item

    したがって、variant × item キーでの { variant: "promo" } はすべての promo 項目を配列として返し、{ item: 2 } を追加すると単一のエントリに絞り込まれます。