Saving Fragment Compositions
レイアウトと構成はページ デザインの基礎となります。 ページの読みやすさとナビゲーション性が向上し、より豊かで一貫性のあるユーザー エクスペリエンスが実現します。 コンテナーとグリッドのレイアウト要素を使用すると、ドロップゾーンを定義し、複雑な構成を作成し、これらの構成を新しいフラグメントとして保存できます。 これらのフラグメントは、フラグメントをサポートする他のページやテンプレートで再利用できます。
構成を設計する際には、まずコンテナフラグメントから始めます。 このコンテナに他の要素を追加することで、最大限の柔軟性とレイアウトコントロールが可能になります。
フラグメント構成を保存するには、次の手順に従います。
-
保存したいコンポジションが含まれているページまたはテンプレートの編集を開始します。
-
目的の コンテナ または グリッドをクリックします。
または、サイドバー メニューで ブラウザー パネル (
) を開き、目的の コンテナー または グリッドを選択します。 -
必要なフラグメントの オプション (
) をクリックし、 コンポジションの保存を選択します。
-
フラグメントの名前を入力します。
-
(オプション) 新しいフラグメントの サムネイル と 説明 を追加します。
-
構成のインラインコンテンツ(リンク、テキスト、画像など)を保存するかどうかを決定します
-
コンポジションの マッピング構成を保存するかどうかを決定します。
-
新しいフラグメントに必要なフラグメント セットを選択します。
利用可能なフラグメント セットが存在しない場合は、コンポジションは「Saved Fragments」と呼ばれる新しいセットに自動的に保存されます。

-
[保存]をクリックします。
保存されたフラグメント構成は、選択したフラグメント セットの下の フラグメント パネルに表示されます。 他のフラグメントと同様に、ページまたはテンプレートに追加できます。
保存したコンポジションを表示および管理するには、 サイト メニュー を開き、 デザイン → フラグメントに移動します。
Liferay DXP 7.1 および 7.2 では、 製品メニューを開き、 サイト → サイトビルダー → ページフラグメントに移動します。
ここから、保存したコンポジションの名前を変更したり、サムネイル画像を変更したり、 .zip ファイルとしてエクスポートしたり、セット間で移動したり、削除したりすることができます。 詳細については、 フラグメントの管理 を参照してください。

例:バナーコンポジションの作成
このステップバイステップの例では、ネストされたコンテナ フラグメントを使用してバナー スタイルのコンポジションを作成する方法を示します。 この例では、コンポジションを保存し、スタイル ブックで設定を調整する方法も示します。

- ステップ 1: 新しいコンテンツ ページを作成する。
- ステップ 2: コンテナ フラグメントの構成。
- ステップ 3: フラグメント構成を保存する。
- ステップ 4: スタイル ブックで既定のコンテナーの幅を設定する。
ステップ1:新しいコンテントページの作成
-
サイトメニューで、 サイトビルダー → ページに移動します。
-
新しいページを追加するレベルで 追加 (
) をクリックし、 ページの追加を選択します。 -
空白テンプレート、または既存のテンプレートのいずれかを選択します。
-
ページの追加 ダイアログで、ページの名前を入力します。
ステップ2:コンテナフラグメントの設定
-
コンテンツ ページのサイドバーから、 フラグメントとウィジェット (
) を選択し、 コンテナー フラグメントをデフォルトのドロップ ゾーンにドラッグ アンド ドロップします。
-
コンテナー フラグメントをクリックし、 構成 パネルで、 スタイル タブをクリックします。
-
間隔パネルで、4 つの パディング オプションを
5に設定します。 -
背景パネルで、 スタイルブックからの値 ボタンを使用して、 グレー 200を選択します。

-
フラグメントとウィジェット (
) を選択し、新しい コンテナー フラグメントを既存のフラグメントの上にドロップします。 これにより、 ブラウザ (
) ボタンをクリックしたときに表示されるネストされたコンテナ構成が作成されます。 -
フラグメントとウィジェット(
)パネルの「基本コンポーネント」の下で、 見出し フラグメントをコンポジションの内部コンテナー内にドラッグ アンド ドロップします。
-
段落 フラグメントを見出しのすぐ下にドラッグ アンド ドロップします。 構成内の段落を選択し、 スタイル セクションで、 上余白 として
3を選択します。
-
選択(
)パネルから、内側のコンテナをクリックします。 [General] タブで、ユーザーがこの領域をクリックしたときにリダイレクトさせるURLを入力します。
-
フラグメントとウィジェット (
) パネルの [基本コンポーネント] から、 ボタン フラグメントを、段落のすぐ下のコンポジションにドラッグ アンド ドロップします。 -
ボタン フラグメントを選択し、スタイル セクションで、 上余白 を
3に設定します。 [一般] セクションで、 [タイプ] ドロップダウン メニューをクリックし、 [リンク]を選択します。 -
ブラウザ(
)パネルで、ボタンの リンク をクリックします。 リンク セクションの下に、ボタンをクリックしたときにユーザーをリダイレクトする URL を入力します。
コンテンツ ページを公開する必要はありません。 コンテンツ ページで進行中の作業は、下書きとして自動的に保存されます。
ステップ3: フラグメント構成の保存
上記の手順に従って、コンポジションを新しいフラグメントとして保存します。

ステップ4:スタイルブックにおけるデフォルトのコンテナ幅の設定
デフォルトでは、コンテナ フラグメントは Fluid 幅構成を使用します。 デフォルト設定を 固定幅に変更し、同じスタイル ブックに基づく他のコンテンツ ページでこのプロパティを使用できるようにすることができます。 ネストされた 2 つのコンテナーがあるこの例では、テキストを含むコンテナーの最大幅を制限しながら、ページの幅に合わせて外側のコンテナーを構成することができます。 Liferay DXP のスタイルブックの詳細については、「 スタイルブックを使用してサイトの外観を標準化する」をお読みください。

サイトのレイアウト構成が壊れないようにするには、スタイル ブックを使用するときはテスト環境を使用します。 実稼働サイトでのテスト目的でスタイル ブックの構成を更新しないでください。
-
ブラウザ (
) を開き、内部コンテナ フラグメントをクリックします。 -
[全般] タブで、 コンテナーの幅 プロパティを 固定幅に設定します。

-
ページ デザイン オプション (
) をクリックし、スタイル ブック セクションでアクティブなスタイル ブックを確認します。
-
サイトメニューで、 デザイン → スタイルブックに移動します。

-
コンテンツ ページに対応するスタイル ブックの [アクション] (
) をクリックし、 [編集]を選択します。 -
スタイル ブック エディターで、 ページ プレビュー ドロップダウン メニューからコンテンツ ページを選択します。
![スタイル ブック エディターの [ページ プレビュー] ドロップダウン メニューから、変更するコンテンツ ページを選択します。](https://resources.learn.liferay.com/images/dxp/latest/en/sites/creating-pages/page-fragments-and-widgets/using-fragments/saving-fragment-compositions/images/16.png)
-
右側のドロップダウンメニューから [レイアウト] オプションを選択し、 [特大] オプションで固定幅要素の最大幅値(ピクセル単位)を設定します。

-
公開 をクリックして、スタイル ブックを新しい構成で更新します。
コンテナフラグメントを使った高度なコンポジションの作成
Liferay DXP/ポータル 7.4 以上
別のコンテナ フラグメント内に 1 つ以上のコンテナを構成する場合、 Flex ディスプレイを使用して高度な表示オプションを定義できます。
-
サイトメニューで、 サイトビルダー → ページに移動します。
-
新しいコンテンツ ページを作成するか 、コンテナー ベースの構成で既存のページを開きます。 バナー構成の例 を使用して、コンテナ フラグメントを使用した基本的な構成を作成できます。
-
ブラウザ (
) を開き、高度な構成を適用する要素をグループ化するコンテナ フラグメントを選択します。 たとえば、フラグメントが入ったコンテナがある場合は、外側のコンテナを選択します。 -
スタイルセクションで、 [コンテンツの表示]ドロップダウンメニューをクリックし、利用可能な [Flex] オプションから一つを選択します。
-
項目の配置 と コンテンツの両端揃え の設定を好みに合わせて設定します。
