エクスペリエンスフラグメントコンポーネント

最終更新日： 2025年6月27日

作成対象：

  • 開発者
  • 管理者
  • ユーザー

コンテンツ作成者は、コアコンポーネントのエクスペリエンスフラグメントコンポーネントを使用して、ローカライズされたサイト構造をサポートしながら、エクスペリエンスフラグメントのバリエーションをページに配置できます。

ヒント
AEM 向け Edge Delivery Servicesについて検討したことはありますか？
既存のプロジェクトでは、このドキュメントで説明されている方法を引き続き使用できます。ただし、新規プロジェクトの場合は、Edge Delivery Services を利用することをお勧めします

使用方法

コアコンポーネントのエクスペリエンスフラグメントコンポーネントを使用すると、コンテンツ作成者が、既存のエクスペリエンスフラグメントバリエーションから選択してコンテンツページに配置できます。エクスペリエンスフラグメントコンポーネントでは、ローカライズされたサイト構造もサポートしています。

バージョンと互換性

このドキュメントでは、エクスペリエンスフラグメントコンポーネントの現在のバージョン（2022年2月にコアコンポーネントのリリース 2.18.0 で導入された v2）について説明します。

コンポーネントのすべてのサポート対象バージョン、コンポーネントの各バージョンと互換性のある AEM バージョン、以前のバージョンのドキュメントへのリンクを次の表に示します。

コンポーネントのバージョンAEM 6.4AEM 6.5AEM 6.5 LTSAEM as a Cloud Service
v2-互換性あり互換性あり互換性あり
v1互換性あり互換性あり-互換性あり

コアコンポーネントのバージョンとリリースについて詳しくは、コアコンポーネントのバージョンを参照してください。

ローカライズされたサイト構造のサポート

エクスペリエンスフラグメントコンポーネントは、ローカライズされたサイト構造に適応でき、ページのローカリゼーションに基づいて適切なエクスペリエンスフラグメントをレンダリングします。それには、エクスペリエンスフラグメントが次の条件を満たす必要があります。

  • エクスペリエンスフラグメントコンポーネントがテンプレートに追加される。
  • このテンプレートが、/content/<site> 配下のローカライズされた構造の一部となる新しいコンテンツページの作成に使用される。
  • コンテンツページで参照されるエクスペリエンスフラグメントが、同じコンポーネント名を使用するなど、/content/<site> 配下のサイトと同じパターンに従っており、/content/experience-fragments 配下のローカライズされたエクスペリエンスフラグメント構造の一部となる。

この場合、現在のページと同じローカリゼーション（言語、ブループリント、ライブコピーのいずれか）を持つフラグメントがテンプレートの一部としてレンダリングされます。

この動作は、テンプレートに追加されたエクスペリエンスフラグメントコンポーネントに限られます。個々のコンテンツページに追加されたエクスペリエンスフラグメントコンポーネントは、コンポーネント内で設定されたとおりのエクスペリエンスフラグメントレンディションをレンダリングします。

例

コンテンツが次のような構造になっているとします。

/content
+-- experience-fragments
   \-- wknd
      +-- language-masters
      +-- us
         +-- en
            +-- footerTextXf
            \-- headerTextXf
         \-- es
            +-- footerTextXf
            \-- headerTextXf
      \-- ch
         +-- de
            +-- footerTextXf
            \-- headerTextXf
         +-- fr
            +-- footerTextXf
            \-- headerTextXf
         \-- it
            +-- footerTextXf
            \-- headerTextXf
+-- wknd
   +-- language-masters
   +-- us
      +-- en
      \-- es
   +-- ch
      +-- de
      +-- fr
      \-- it
+-- wknd-events
\-- wknd-shop

/content/experience-fragments/wknd 配下の構造が /content/wknd の構造を反映していることに注意してください。

このとき、エクスペリエンスフラグメントコンポーネント /content/experience-fragments/wknd/us/en/footerTextXf がテンプレートに配置される場合、ローカライズされたページをそのテンプレートに基づいて作成すると、ローカライズされたコンテンツページに対応するローカライズされたエクスペリエンスフラグメントが自動的にレンダリングされます。

したがって、同じテンプレートを使用する /content/wknd/ch/de 配下のコンテンツページに移動すると、/content/experience-fragments/wknd/us/en/footerTextXf ではなく /content/experience-fragments/wknd/ch/de/footerTextXf がレンダリングされます。

フォールバック

エクスペリエンスフラグメントコンポーネントでは、対応するローカライズされたコンポーネントを次の順序で探します。

  1. まず、言語ルートを探します。
  2. 言語ルートが見つからない場合は、ブループリントを探します。
  3. ブループリントが見つからない場合は、ライブコピーを探します。
  4. ライブコピーが見つからない場合は、コンポーネントで設定されているエクスペリエンスフラグメントがデフォルトで選択されます。

コンポーネント出力のサンプル

エクスペリエンスフラグメントコンポーネントを体験し、その設定オプションや HTML および JSON 出力の例を確認するには、コンポーネントライブラリを参照してください。