フラグメントサブ要素リファレンス
一般 および スタイル 設定に加えて、多くのフラグメントには独自の構成オプションを持つサブ要素が含まれています。 これらのオプションにアクセスするには、ページまたはテンプレートの編集を開始し (
)、目的のフラグメントをクリックして、ブラウザー (
) サイドバー メニューでそのサブ要素の 1 つを選択します。
使用可能なオプションは、サブ要素のタイプによって異なり、［マッピング］、［画像ソース］、および［リンク］のタブに編成されています。
| サブ要素のタイプ | ［マッピング］タブ | ［画像ソース］タブ | ［リンク］タブ |
|---|---|---|---|
シンプルなテキスト要素 ( ) | ✅ | ❌ | ✅ |
リッチテキスト要素 ( ) | ✅ | ❌ | ❌ |
リンク要素 ( ) | ✅ | ❌ | ✅ |
HTML要素 ( ) | ✅ | ❌ | ❌ |
画像要素 ( ) | ❌ | ✅ | ✅ |
マッピング設定
選択した要素を既存のアセットのフィールドにマップします。
| 項目 | 説明 |
|---|---|
| 項目 | ドキュメントとメディア、Webコンテンツ、ブログ、またはカテゴリからアセットを選択します。 選択したアセットによって、マッピング用のフィールドが提供されます。 |
| 項目 | 選択した項目のサポートされているフィールドに要素をマップします。 |
サポートされているフィールドには、テキスト、リストからの選択、単一選択、複数選択、日付、日付と時刻、数値、ブール値、ページへのリンク、リッチ テキストが含まれます。
画像ソース設定
選択した画像要素に表示される画像を設定します。
フラグメントでは、コンテンツ配信ネットワーク (CDN) ホストに保存されている画像を表示できません。 フラグメント内で CDN ホストを通じて提供される画像を参照しないでください。
| 項目 | 説明 |
|---|---|
| ソースの選択 | 画像要素がソースに ［Direct］または［マッピング］のどちらを使用するかを選択します。 ［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の場合は) には、テキスト、リストから選択、単一選択、複数選択、数値、リッチ テキスト、ページへのリンクなどの要素をマップできます。
