フラグメント要素リファレンス
一般 および スタイル 設定に加えて、多くのフラグメントには独自の構成オプションを持つ要素が含まれています。 これらのオプションにアクセスするには、ページまたはテンプレートの編集を開始し(
)、目的のフラグメントをクリックして、ブラウザ(
)のサイドバーメニューで要素を選択します。

利用可能なオプションは要素の種類によって異なり、「マッピング」、「画像ソース」、「リンク」のタブに整理されています。
| 要素タイプ | [マッピング]タブ | [画像ソース]タブ | [リンク]タブ |
|---|---|---|---|
| シンプルなテキスト要素 ( | ✅ | ❌ | ✅ |
| リッチテキスト要素 ( | ✅ | ❌ | ❌ |
| リンク要素 ( | ✅ | ❌ | ✅ |
| HTML要素( | ✅ | ❌ | ❌ |
| 画像要素 ( | ❌ | ✅ | ✅ |
マッピング設定
選択した要素を既存のアセットのフィールドにマップします。
フィールドをマッピングする際に CMS アセット を使用するには、 Liferay でのコンテンツ管理システムアセットの使用 を参照してください。
| 項目 | 説明 |
|---|---|
| 項目 | ドキュメントとメディア、Webコンテンツ、ブログ、またはカテゴリからアセットを選択します。 選択したアセットによって、マッピング用のフィールドが提供されます。 |
| 項目 | 選択したアイテムのサポートされているフィールドに要素をマッピングします。 |
サポートされているフィールドには、テキスト、リストからの選択、単一選択、複数選択、日付、日時、数値、ブール値、ページへのリンク、リッチテキストなどがあります。

画像ソース設定
選択した要素に表示される画像を設定します。
フラグメントでは、コンテンツ配信ネットワーク(CDN)ホストに保存されている画像を表示できません。 フラグメント内でCDNホスト経由で配信される画像を参照しないでください。
| 項目 | 説明 |
|---|---|
| ソースの選択 | 要素のソースとして、 Direct または Mapping のどちらを使用するかを選択します。 [Direct]を使用する場合は、ドキュメントとメディアから画像を選択するか、画像URLを入力できます。 マッピング機能を使用する場合、ドキュメントとメディア、Webコンテンツ、ブログ、またはカテゴリからアセットを選択し、選択したアセットのフィールドに要素をマッピングできます。 |
| 画像(ダイレクト用) | ドキュメントライブラリから目的の画像を選択するか、画像URLを入力します。 |
| 解像度(ダイレクト用) | 画像の解像度を選択します。 デフォルトでは、Liferayには自動、サムネイル(300px)、またはプレビュー(1000px)のオプションが含まれています。 ただし、アダプティブメディアを使用して 代替解像度を生成することができます。 |
| 画像の説明(ダイレクトリンクの場合は、ダイレクトリンクの場合は) | ローカライズ可能な画像の説明を入力します。 他の言語の説明を設定するには、まず編集バーからページまたはテンプレートの言語を切り替えてください。 次に、目的のテキストを入力します。 詳細については、 フラグメント構成フィールドのローカライズ を参照してください。 |
| 項目(マッピング用) | ドキュメントとメディア、Webコンテンツ、ブログ、またはカテゴリからアセットを選択します。 選択したアセットによって、マッピング用のフィールドが提供されます。 |
| フィールド(マッピング用) | 選択したアイテムから目的のフィールドに要素をマップします。 |
| 遅延読み込みを有効にする | 必要なときにのみ画像をレンダリングするには、 遅延読み込み を有効にします。 有効になっている場合でも、ページの初期レンダリング時には画面外の画像は読み込まれません。 これにより、クリティカルレンダリングパスを短縮し、ページ読み込み時間を短縮できます。 デフォルトでは、遅延読み込みは無効になっています。 |

ソース選択に ダイレクト オプションを使用すると、画像の URL がフラグメントの編集可能な値に保存されますが、サイトのフレンドリー URL が変更されると、この保存方法が壊れる可能性があります。
これを回避するには、 マッピング オプションを使用し、ドキュメントとメディアからアイテムを選択して、フィールドとして ファイル URL を選択します。 これにより、画像URLが編集可能な値に保存されず、サイトのフレンドリーURLが変更された場合でも機能が維持されます。
リンク設定
選択した要素にクリック可能なリンクを追加するには、URL、ページ参照、またはアセットマッピングを設定します。
| 項目 | 説明 |
|---|---|
| リンク | フィールドが URL、 ページ、または マップされた URL を使用しているかどうかを判断します。 |
| URL (は URL 用) | 要素のローカライズ可能なURLを入力します。 他の言語のURLを設定するには、まず編集バーからページまたはテンプレートの言語を切り替えてください。 次に、目的のURLを入力します。 詳細については、 フラグメント構成フィールドのローカライズ を参照してください。 |
| ページ(のページ) | 要素に対応するLiferayページを選択してください。 |
| アイテム(マッピングされた URL 用) | ドキュメントとメディア、Webコンテンツ、ブログ、またはカテゴリからアセットを選択します。 選択したアセットによって、マッピング用のフィールドが提供されます。 |
| フィールド(マッピングされた URL 用) | 要素を、アイテム内の利用可能なサポート対象のURLフィールドにマッピングします。 有効なフィールドを選択すると、URLフィールドに自動的に入力されます。 |
| URL (はマッピングされた URL 用) | このフィールドは、マッピングされたURLフィールドによって自動的に入力されます。 |
| 新しいタブで開く | クリックしたリンクを新しいタブで開くかどうかを決定します。 |
以下の要素をフィールドにマッピングできます(マッピングされた URL の場合は、マッピングされた URL の場合は):テキスト、リストからの選択、単一選択、複数選択、数値、リッチテキスト、およびページへのリンク。
