Using Fragments
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

Saving Fragment Compositions

レイアウトと構成は、ページデザインの基礎となるものです。 それらはページの読みやすさとナビゲーション性を向上させ、より豊かで一貫性のあるユーザーエクスペリエンスをもたらします。 コンテナとグリッドのレイアウト要素を使用すると、ドロップゾーンを定義したり、複雑な構成を作成したり、これらの構成を新しいフラグメントとして保存したりできます。 これらのフラグメントは、フラグメントをサポートする他のページやテンプレートで再利用できます。

ヒント

構成を設計する際には、まずコンテナフラグメントから始めます。 このコンテナに他の要素を追加することで、最大限の柔軟性とレイアウトコントロールが可能になります。

フラグメント構成を保存するには、以下の手順に従ってください。

  1. 保存したい構成が含まれているページまたはテンプレートの編集を開始します。

  2. 目的の コンテナ または グリッド をクリックします。

    または、サイドバーメニューの ブラウザー パネル(Browser)を開き、目的の コンテナ または グリッドを選択します。

  3. 目的のフラグメントの オプション (Options icon) をクリックし、 コンポジションの保存 を選択します。

    フラグメントのオプションメニューを開き、「コンポジションを保存」を選択します。

  4. フラグメントの名前を入力してください。

  5. (オプション)新しいフラグメントに サムネイル説明 を追加します。

  6. 構成のインラインコンテンツ(リンク、テキスト、画像など)を保存するかどうかを決定します

  7. コンポジションの マッピング構成 を保存するかどうかを決定します。

  8. 新しいフラグメントに使用するフラグメントセットを選択してください。

    利用可能なフラグメントセットが存在しない場合、構成は「保存済みフラグメント」と呼ばれる新しいセットに自動的に保存されます。

    表示されるダイアログに、フラグメント構成に関する情報を入力してください。

  9. [Save(保存)]をクリックします。

保存されたフラグメント構成は、選択したフラグメントセットの下にある フラグメント パネルに表示されます。 他のフラグメントと同様に、ページやテンプレートに追加できます。

保存された構成を表示および管理するには、 サイトメニュー を開き、 デザインフラグメント に移動します。

Liferay DXP 7.1 および 7.2 では、 製品メニューを開き、 サイトサイトビルダーページフラグメント に移動します。

ここから、保存したコンポジションの名前を変更したり、サムネイル画像を変更したり、 .zip ファイルとしてエクスポートしたり、セット間で移動したり、削除したりできます。 詳細については、 フラグメントの管理 を参照してください。

保存されたフラグメント構成はすぐに使用できます。

例:バナーコンポジションの作成

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

コンテナフラグメントを使用したサンプルフラグメント構成の例

ステップ1:新しいコンテントページの作成

  1. サイトメニューから、 サイトビルダーページ に移動します。

  2. 新しいページを追加したいレベルで、 追加 (Add Page) をクリックし、 ページの追加 を選択します。

  3. 空白テンプレート、または既存のテンプレートのいずれかを選択します。

  4. ページの追加 ダイアログで、ページの名前を入力します。

ステップ2:コンテナフラグメントの設定

  1. コンテンツページのサイドバーから、 フラグメントとウィジェット (Fragments and Widgets) を選択し、 コンテナ フラグメントをデフォルトのドロップゾーンにドラッグアンドドロップします。

    コンテナフラグメントをコンテンツページのドロップゾーンの上にドラッグアンドドロップします。

  2. コンテナ フラグメントをクリックし、 設定 パネルで、 スタイル タブをクリックします。

  3. スペーシング パネルで、4 つの パディング オプションを 5 に設定します。

  4. 背景パネルで、 スタイルブックからの値 タブを使用して、 Gray 200 を選択します。

    コンテナフラグメントのパディングと背景色の値を定義します。

  5. フラグメントとウィジェット (Fragments and Widgets) を選択し、新しい コンテナ フラグメントを既存のフラグメントの上にドロップします。 これにより、 ブラウザ (Browser) ボタンをクリックしたときに表示されるネストされたコンテナ構成が作成されます。

  6. フラグメントとウィジェット (Fragments and Widgets) パネルの「基本コンポーネント」から、 見出し フラグメントをコンポジション内のインナーコンテナにドラッグアンドドロップします。

    見出しフラグメントを内部コンテナフラグメント内にドラッグアンドドロップします。

  7. 見出しのすぐ下に 段落 フラグメントをドラッグアンドドロップします。 構成内の段落を選択し、 スタイル セクションで、 上余白3 に設定します。

    見出しフラグメントのすぐ下に段落フラグメントをドラッグアンドドロップします。

  8. 選択パネル(Selection)から、内側のコンテナをクリックします。 [General] タブで、ユーザーがこの領域をクリックしたときにリダイレクトさせるURLを入力します。

    内部コンテナフラグメントのターゲットリンクまたはページを定義します。

  9. フラグメントとウィジェット (Fragments and Widgets) パネルの「基本コンポーネント」から、 ボタン フラグメントを段落のすぐ下にドラッグアンドドロップします。

  10. ボタン フラグメントを選択し、[スタイル] セクションで 上余白3 に設定します。 一般 セクションで、 タイプ ドロップダウン メニューをクリックし、 リンク を選択します。

  11. ブラウザ(Browser)パネルで、ボタンのリンク をクリックします。 リンク欄に、ボタンをクリックした際にユーザーがリダイレクトされるURLを入力してください。

    ボタンフラグメントのタイプと上部マージンを設定します。

コンテンツページを公開する必要はありません。 コンテンツページの作業途中の内容は、自動的に下書きとして保存されます。

ステップ3: フラグメント構成の保存

上記の手順に従って、コンポジションを新しいフラグメントとして保存します。

コンテナオプションメニューからフラグメント構成を保存します。

ステップ4:スタイルブックにおけるデフォルトのコンテナ幅の設定

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

コンテナの幅プロパティを変更することで、固定幅を使用するか、ページ幅に合わせて調整するかを選択できます。

警告

サイトのレイアウト設定が崩れるのを避けるため、スタイルブックを扱う際はテスト環境を使用してください。 テスト目的で本番環境のサイトでスタイルブックの設定を更新しないでください。

  1. ブラウザ (Browser) を開き、内側のコンテナフラグメントをクリックします。

  2. [General]タブで、[Container Width]プロパティを[Fixed Width]に設定します。

    内部コンテナフラグメントの幅設定を「固定幅」に変更してください。

  3. ページデザインオプションPage Design Options)をクリックし、スタイルブックのセクションで、アクティブなスタイルブックを確認します。

    コンテントページで使用されているデフォルトのスタイルブックを確認します。

  4. サイトメニューから、 デザインスタイルブック に移動します。

    サイトメニューとデザインセクションのスタイルブックページを開きます。

  5. コンテンツページに対応するスタイルブックの アクション (Actions) をクリックし、 編集 を選択します。

  6. スタイルブックエディターで、 ページプレビュー ドロップダウンメニューからコンテンツページを選択します。

    スタイルブックエディタの「ページプレビュー」ドロップダウンメニューから、変更したいコンテンツページを選択してください。

  7. 右側のドロップダウンメニューから [レイアウト] オプションを選択し、 [特大] オプションで固定幅要素の最大幅値(ピクセル単位)を設定します。

    スタイルブックのレイアウト設定にある「特大」オプションを変更すると、コンテナフラグメントの最大幅が更新されます。

  8. 公開 をクリックして、スタイルブックを新しい設定で更新します。

コンテナフラグメントを使った高度なコンポジションの作成

Liferay DXP/Portal 7.4以降

別のコンテナフラグメント内に 1 つ以上のコンテナを設定すると、 Flex ディスプレイを使用して高度な表示オプションを定義できます。

  1. サイトメニューから、 サイトビルダーページ に移動します。

  2. 新しいコンテンツページ を作成するか、コンテナベースの構成を持つ既存のページを開きます。 コンテナフラグメントを使用した基本的な構成を作成するには、バナー構成例 を使用できます。

  3. ブラウザ (Browser) を開き、高度な合成を適用する要素をグループ化するコンテナフラグメントを選択します。 例えば、フラグメントを含むコンテナがある場合、外側のコンテナを選択します。

  4. スタイルセクションで、 [コンテンツの表示]ドロップダウンメニューをクリックし、利用可能な [Flex] オプションから一つを選択します。

  5. アイテムの配置コンテンツの均等割り付け の設定を好みに合わせて変更してください。

    Flex表示オプションを使用してスタイルを適用したいページ要素をグループ化するコンテナを選択します。