コレクションの表示
Liferay Portal 7.4 GA6+、DXP 7.3 GA1+
コレクション ページまたはコレクション表示フラグメントを追加することで、コレクションを表示できます。 これらの表示オプションの詳細については、「 コレクションとコレクション ページについて」を参照してください。
デフォルトでは、すべてのユーザーがコレクションのコンテンツを表示できます。 ただし、セグメントを使用して、ユーザーがこのコンテンツをどのように表示するかを カスタマイズできます。
ページに表示する前に、コレクションを 作成 する必要があります。
ページにコレクションを表示する
コレクションを表示する最も簡単な方法は、コレクション ページを作成するか、既存のページにコレクション表示フラグメントを追加することです。
コレクションページでコレクションを表示する
Liferay DXP 2025.Q1+/Portal GA132+以降では、Pages アプリケーションでコレクション ページが利用できなくなったため、 コレクション表示フラグメント を使用して、好みの形式でコレクションを表示します。
アップグレード プロセス中に、既存のコレクション ページは自動的に コンテンツ ページに変換されます。
コレクション ページはページをコレクションにリンクします。 コレクション ページには、ページの一部として コレクション表示フラグメント が含まれます。
コレクションページを作成するには、
-
サイト メニュー (
) を開き、 サイト ビルダーを展開して、 ページに移動します。 -
新規 をクリックし、 コレクション ページを選択します。
-
[コレクション] タブからコレクションを 1 つ選択するか、 [追加] (
) をクリックして [新しいコレクションを作成]します。 -
使用する［マスターページ］を選択します。
-
コレクション ページの名前を入力し、 [追加]をクリックします。
-
コレクションを表示するには、 そのコンテンツをページ要素にマッピングします。
コレクション ページの下に子ページを作成することはできません。
これで、コレクション表示フラグメント内に、選択したコレクションを表示するコレクション ページが作成されました。
コレクション表示フラグメントをページに追加する
コレクション表示フラグメントは、コンテンツ ページにコレクションを表示します。 コレクションを任意のスタイルやレイアウトで表示するように構成できます。
既存のコレクションをコレクション表示フラグメントに追加するには、
-
追加 (
) をクリックして、フラグメントとウィジェット パネルを開きます。 -
「フラグメント」タブの「コンテンツ表示」カテゴリで、 「コレクション表示」 フラグメントをページ上の任意の場所にドラッグします。
-
コレクション表示 フラグメントをクリックすると、選択パネルに構成が表示されます。
-
[全般] タブで、 コレクション フィールドをクリックして、選択したコレクションをフラグメントにマッピングします。
コレクション表示フラグメントがページ上に表示され、選択したコレクションが表示されます。
ページにコレクション表示フラグメントを追加する場合、編集可能なフラグメントにマップできるコレクションのみを使用できます (ブログ エントリ、ドキュメント、ナレッジ ベース記事、Web コンテンツ記事、カスタム オブジェクト エントリ)。
コレクション表示フラグメントの設定
カスタム コレクションではインスタンス スコープのオブジェクトを表示できません。
コレクション表示フラグメントを手動で追加したか、コレクション ページ経由で追加したかに関係なく、 ページを編集して フラグメントを選択することで設定できます。
コレクション表示フラグメントを選択すると、コレクション内の各アセットのセクションに分割されます。 コレクションを選択すると、フラグメントの一般設定の下に新しいオプションが表示されます。
スタイル表示: リスト内のアセットのフォーマットに使用するスタイルを選択します (例: グリッドまたは箇条書きリストのスタイル)。 7.4 GA23 または U23 より前のバージョンでは、この構成はリスト スタイルと呼ばれます。
レイアウト: アセットを表示する列の数を選択します。
ガターを表示: 列間のガター (間隔) を表示するには、チェックボックスをオンにします。 このオプションは、列レイアウトでグリッド スタイルを選択した場合にのみ表示されます (バージョン 7.4 GA23+ または U23+)。
空のコレクションアラートを表示: 適用したフィルターに一致する結果がない場合、またはコレクションが空の場合にアラート メッセージを表示するには、このボックスをオンにします。
空のコレクションアラート: 空のコレクションアラートを表示 が有効になっている場合は、表示されるアラートメッセージを選択します。 このメッセージはローカライズ可能です。
垂直方向の配置: 項目を各行の上、中央、または下に配置する方法を選択します。 このオプションは、 グリッド スタイルを選択した場合にのみ表示されます (バージョン 7.4 GA23+ または U23+)。
リスト項目スタイル: 各アセットをフォーマットするスタイルを選択します。 このオプションは一部のリスト スタイルにのみ適用されます。
アイテムの最大数: フラグメントが一度に表示できるアセットの最大数を選択します。
コレクション内のアセットを構成どおりに表示する準備ができたら、ページを公開します。
Liferay 7.4 GA23+ または U23+ では、コレクション表示フラグメントにグリッド スタイルを選択した場合、デバイスのタイプごとにレイアウト設定を個別に構成できます。 各デバイスに対してこの設定を設定するには、画面上部のデバイス ビューポート ボタンをクリックします。 タブレットの設定はデフォルトでデスクトップの設定と同じになり、縦向きと横向きの電話の設定はデフォルトで 1 列になります。
コレクションのアセットを表示するためのコンポーネントのマッピング
表示コンポーネントをフラグメントにマッピングすることで、フラグメント内の項目のスタイル (各アセットを個別に表示する方法) を構成することもできます。
これらの要素をフラグメントのセル内にドラッグして、コレクション表示フラグメント内のアセットにマップします。
コレクション表示フラグメントのリスト スタイルに選択したオプションによっては、フラグメントにコンポーネントをドラッグできない場合があります。 コンポーネントをフラグメントにドラッグできない場合は、別のリスト スタイルを選択するか、「リスト項目スタイル」で別のオプションを選択できます。
-
ページ エディターで、コレクションを表す コレクション表示 をクリックします。
-
ツールサイドバーで、 フラグメントとウィジェット （
）をクリックします。 -
フラグメントとウィジェットのサイドバー パネルから、コレクション アイテムを表示するために使用するコンポーネントをドラッグ アンド ドロップします。
Liferay DXP 2025.Q2 より前は、フラグメントまたはウィジェットをコレクション表示内の任意の項目にドラッグできました。 レイアウト設定は、コレクション内の残りのアイテムに自動的に適用されます。
Liferay DXP 2025.Q2 以降、フラグメントはコレクションの最初の項目にのみドロップしてマッピングできます。 レイアウト設定は、コレクション内のすべてのアイテムに自動的に適用されます。
-
コレクション表示フラグメント上の フラグメント または ウィジェット をダブルクリックして、マッピング オプションにアクセスします。
-
マッピング列で、コレクションにマッピングする フィールド を選択します。
-
必要に応じてフラグメントまたはウィジェットを追加し、コンテンツをコンテンツ フィールドにマップします。
-
公開をクリックします。
表示項目のページネーション
Liferay DXP 7.4+
ページ区切り設定を使用してコレクション アイテムをページ区切りできます。 このオプションには、2つの重要な利点があります。
-
アイテム数の多いコレクションを表示するのが簡単になります。 コレクション内のすべてのアイテムを表示する代わりに、ユーザーがコレクション内のアイテムのリスト内を前後に移動できるようにしながら、一度に表示するアイテムの数を決定することができます。
-
閲覧可能なアイテムのリストを小さなグループに分割すると、サーバーのオーバーヘッドが削減され、サーバーの応答時間とユーザーエクスペリエンスが向上します。
U18 および GA18 より前の Liferay 7.4 バージョンでは、利用できるページ区切りオプションが少なくなります。 これらのバージョンでは、ページ区切りを有効にして、一度に表示するアイテムの最大数を選択することはできますが、ページ区切りメニューに表示されるページ数を変更することはできません。
コレクション表示で表示項目をページ付けするには、
-
コレクションが表示されているコンテンツページで、 編集 （
）をクリックします。 -
ブラウザ (
) をクリックしてブラウザ パネルを開きます。 -
要素ブラウザで、ページ番号を付けるコレクション表示フラグメントを選択します。 選択したフラグメントは、既存のコレクションを表示するように構成する必要があります。
-
一般設定で、ページネーションオプションを選択します。
ページ区切り: なし (ページ区切りなし)、数値、またはシンプル (前へ/次へのコントロール)。
すべてのページを表示: ページ区切りメニューに各ページの番号またはコントロールを表示するには、チェックボックスをオンにします。 ページ区切りタイプが選択されていない場合、このオプションは代わりに「すべてのコレクション項目を表示」になります。
表示するページの最大数: ページネーションメニューに表示されるページの最大数。 このオプションは、「すべてのページを表示」チェックボックスが選択されていない場合にのみ表示されます。
ページあたりの最大アイテム数: ページ区切りが有効な場合に、ページごとに表示するコレクションのアイテムの最大数。 ページ区切りタイプが選択されていない場合、このオプションは代わりに「表示するアイテムの最大数」になります。
ページ区切りを有効にすると、使用可能なページの合計数は、コレクション内のアイテムの合計数と、ページあたりの最大アイテム数の設定の両方によって決まります。
デフォルトでは、コレクション表示フラグメントは編集モードで一度に最大 20 個の項目を表示します。 この制限を変更するには、 コントロール パネル → インスタンス設定 → ページ → ページ エディターに移動し、 編集モードでのアイテムの最大数 フィールドの数値を変更します。 編集モードで一度に 20 個を超える項目を表示すると、パフォーマンスに悪影響を与える可能性があります。 この設定は、表示モードでユーザーがページ上で見る内容には影響しません。
サイト全体でのコレクションの使用状況の表示
サイトのコレクションの使用状況統計を確認できます。
-
サイト メニュー (
) を開き、 サイト ビルダーを展開して、 コレクションに移動します。 -
コレクションタブで、確認するコレクションの横にある アクション (
) → 使用状況の表示 をクリックします。
