繰り返し可能なフィールドをフラグメントにマッピングする
Liferay DXP 2024.Q3+/ポータル GA125+
Web コンテンツ構造にフィールドを作成するときに、それらを 繰り返し可能にすることができます。 その後、これらのフィールドをフラグメントにマップし、ページに公開できます。 これは、FAQ、求人情報、または以下の例のような従業員ディレクトリなど、パターンに従った構造化されたコンテンツを公開するのに最適な方法です。
繰り返し可能なフィールドを使用したWebコンテンツ構造の作成
この例では、架空のソフトウェア会社の従業員に関する基本情報を格納するための、繰り返し可能なフィールド グループを持つ構造を作成します。
-
サイト メニュー (
) を開き、 コンテンツ & データを展開して、 Web コンテンツに移動します。 -
構造 タブを選択し、 新規をクリックします。 構造に
従業員情報という名前を付けます。 -
テキスト フィールドを構造にドラッグ アンド ドロップします。 ラベルを
名前に変更します。 -
フィールド グループを作成するには、名前フィールドの上に 2 番目の テキスト フィールドを追加します。 ラベルを「
役職」にします。
-
3 番目の テキスト フィールドをフィールド グループに追加して、グループの最後に配置します。 ラベルを
連絡先にします。
-
フィールド グループを選択し、右側で 繰り返し可能 オプションをオンに切り替えます。
右上隅に (
) アイコンが表示され、フィールド グループが繰り返し可能であることが確認されます。
-
[保存]をクリックします。
Webコンテンツ記事の作成
従業員情報 Web コンテンツ構造に基づいて Web コンテンツ記事を作成し、架空の会社のソフトウェア エンジニアに関する情報を追加します。
-
サイト メニュー (
) を開き、 コンテンツ & データを展開して、 Web コンテンツに移動します。 -
Web コンテンツ タブを選択し、 新規をクリックします。 従業員情報 構造を選択します。 記事に
ソフトウェア エンジニアという名前を付けます。 -
従業員の名前、役職、連絡先を追加します。
-
(
) をクリックして、さらにいくつかのフィールド グループの情報を入力します。
-
公開をクリックします。
表示ページテンプレートでの繰り返しフィールドのマッピング
表示ページ テンプレートを作成し、 ソフトウェア エンジニア 記事の繰り返し可能なフィールドをコレクション表示フラグメント内のフラグメントにマップして、会社内のソフトウェア エンジニアのリストを表示します。
-
サイト メニュー (
) を開き、 デザインを展開して、 ページ テンプレートに移動します。 -
[表示ページ テンプレート] タブを選択し、 [新規]をクリックします。 マスター ページを選択します。
-
名前を
ソフトウェア エンジニア リストにします。 コンテンツ タイプとして Web コンテンツ記事 を選択し、サブタイプとして 従業員情報 を選択します。 [保存]をクリックします。 -
フラグメントとウィジェットのサイドバーで、 コレクション表示 フラグメントを探し、ページにドラッグ アンド ドロップします。
-
コレクション表示 フラグメントを選択し、右側の コレクションの選択をクリックします。

-
開いたモーダル ウィンドウで、 [繰り返し可能なフィールド コレクション プロバイダー] タブを選択し、表示するコレクションを選択します。 この例では、
フィールド グループです。
-
フィールド グループ コレクション アイテムに 見出し フラグメントを追加します。
注コレクション表示に複数の項目が含まれている場合は、フラグメントまたはウィジェットをいずれかの項目にドラッグできます。 コレクション内の残りのアイテムでは、同じレイアウト設定が自動的に使用されます。
-
見出し フラグメントをダブルクリックします。 右側のマッピングタブで、フィールドとして 名前 を選択します。

-
同じプロセスを繰り返して、最初のコレクション アイテムにさらに 2 つの見出しフラグメントを追加し、フィールドとして 役職 と 連絡先 を選択します。
-
コレクション アイテムを視覚化するには、連絡先フィールドにマップされている最後の 見出し を選択します。 右側で、 スタイル タブを選択します。 「間隔」の下で、「下余白」として スペーサー 4 を追加します。

-
右上隅の なし → その他の項目を選択 →
ソフトウェア エンジニアをクリックして、表示ページ テンプレートをプレビューします。
最後に、 ソフトウェア エンジニア の記事の繰り返し可能なフィールド グループに追加された情報が表示されます。

コンテンツページ内の繰り返しフィールドを他のフラグメントにマッピングする
繰り返し可能なフィールドをコンテンツ ページ内の他のフラグメントにマップし、表示する反復を選択することもできます。 この例では、特定の部門の従業員の名前を含む、よりシンプルな Web コンテンツ構造と記事を作成します。 次に、コンテンツ ページに追加されたフラグメントに情報をマッピングします。
まず、別の Web コンテンツ構造と記事を作成します。
-
従業員という名前のシンプルな Web コンテンツ構造を作成し、名前というラベルの付いた 1 つの繰り返し可能な テキスト フィールドを作成します。
-
従業員構造に基づいて Web コンテンツ記事を作成します。 好きな名前を付けて、いくつか名前を追加してください。 この例では、
Spanish Employeesという名前で、スペイン人の従業員のリストになっています。
コンテンツ ページを作成し、いくつかの見出しフラグメントを追加して、記事のフィールドをフラグメントにマッピングします。
-
サイト メニュー (
) を開き、 サイト ビルダーを展開して、 ページに移動します。 -
新規 → ページをクリックします。 空白 テンプレートを選択し、名前を付けます。
-
フラグメントとウィジェット サイドバーで、 見出し フラグメントを探し、ページにドラッグ アンド ドロップします。
-
見出し フラグメントをダブルクリックします。 右側で、アイテムとして
スペイン人従業員の記事を選択し、フィールドとして 名前 (繰り返し可能) を選択します。繰り返し可能なフィールドには、
(繰り返し可能)とマークされています。
-
表示する 反復を選択します: 最初、最後、または特定の番号を選択します。
反復回数は 1 から始まります。 特定の番号が存在しない場合は、フィールドは空として表示されます。

この方法では、繰り返し可能なフィールドのリストから特定のフィールドを選択して表示できます。

機能の可用性
| Liferayのバージョン | 機能のステータス | 機能フラグラベル |
|---|---|---|
| Liferay DXP 2024.Q3/ポータル GA125 | リリース | LPD-11377 |
| ライフレイ DXP 2025年第3四半期 | Googleアナリティクス | - |