コマンドリファレンス — 設定属性

最終更新日: 2022-03-09
  • 作成対象:
  • Developer
    User

設定属性は、レスポンシブ画像ライブラリが管理する IMG 要素上で直接属性として定義されます。 各画像には、独自の属性セットを設定できます。

data-src

(オプション)

画像サービングが提供する画像の URL。 URL が存在しない場合、ライブラリは src 属性がフォールバックされた状態。 この属性は、レスポンシブ画像ライブラリが様々な場所から管理する初期画像と動的画像を提供します。

<img data-src="https://s7d9.scene7.com/is/image/Scene7SharedAssets/Backpack_B" data-breakpoints="360,720,940">

src

If data-src が設定されている場合、 src はオプションで、追加する任意の URL を含めることができます。 例えば、ライブラリが使用するのと同じ画像サービングベースの画像への URL を含めることができます。 または、GIFのプレースホルダーやデータ URI を含めて、起動時に余分なサーバーのラウンドトリップを回避することもできます。

If data-src が設定されていない場合、 src は必須で、画像サービングが提供する画像の URL を含める必要があります。

のデータ URI の使用 src の属性と画像サービング URL data-src 属性:

<img src="data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7" data-src="https://s7d9.scene7.com/is/image/Scene7SharedAssets/Backpack_B" data-breakpoints="360,720,940">

data-breakpoints

ブレークポイントのコンマ区切りリスト。オプションでコロン ( :)、画像サービングコマンド、画像プリセットのいずれかです。 各ブレークポイントは、論理 CSS ピクセルで定義される画像の幅の値です。 ライブラリは、リストから最も大きい値を持つ画像を読み込み、実行時の CSS 画像の幅に合わせて、クライアント上で画像をダウンスケールします。 (高密度の画面で作業する場合、サーバーから読み込まれる画像レンディションは、ブレークポイント値にデバイスのピクセル比を掛けた値を表します)。

リスト内の任意のブレークポイントに対して、1 つ以上の画像サービングコマンドまたは画像プリセット名を定義できます。 この特定のブレークポイントが現在アクティブな場合にのみ、画像に適用される追加のパラメーターです。

応答画像のサイズに影響を与える表示コマンド(例: )を除き、サポートされる任意の画像サービングコマンドを使用できます。 wid=, hei=または scl=. 同じ制限が画像プリセットにも当てはまります。レスポンシブ画像ライブラリで使用する画像プリセットには、このようなコマンドを含めないでください。

複数の画像サービングコマンドまたは画像プリセット名は「 &"文字。 画像サービングコマンドの値にコンマが含まれている場合、そのコンマは %2C. 画像プリセット名はドル記号 ( $) をクリックします。

ブレークポイントのみの使用

<img src="https://s7d9.scene7.com/is/image/Scene7SharedAssets/Backpack_B" data-breakpoints="360,720">

画像サービングコマンドの使用

<img src="https://s7d9.scene7.com/is/image/Scene7SharedAssets/Backpack_B" data-breakpoints="360:op_sharpen=1,720:resMode=sharp2&op_usm=0.9%2C1.0%2C8%2C0">

画像プリセットの使用

<img src="https://s7d9.scene7.com/is/image/Scene7SharedAssets/Backpack_B" data-breakpoints="360:$ResponsiveImage_Low$,940:$ResponsiveImage_High$">

画像プリセットおよび画像サービングコマンドの使用

<img src="https://s7d9.scene7.com/is/image/Scene7SharedAssets/Backpack_B" data-breakpoints="360:qlt=50,940:$ResponsiveImage_High$">

data-mode

次の 2 つのスマート切り抜きモードは、AEM 6.4 以降およびDynamic Mediaビューア 5.9 以降で使用できます。

  • 手動 :ユーザー定義のブレークポイントと、対応する画像サービスコマンドは、画像要素の属性内で定義されます。
  • スマート切り抜き :計算済みのスマート切り抜きレンディションは、配信サーバーから自動的に取得されます。 最適なレンディションは、画像要素のランタイムサイズを使用して選択されます。

スマート切り抜きモードを使用するには、 data-mode 属性 smart crop.

<img
src="data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7"
data-src="https://imageserver.com/is/image/ExampleCo/SmartCropAsset"
data-mode="smartcrop">

関連する画像要素は、 s7responsiveViewer イベントを設定します。

         responsiveImage.addEventListener("s7responsiveViewer", function (event) {
           var s7event = event.s7responsiveViewerEvent;
           if(s7event.type == "breakpointchanged") {
              console.log("New width: " + s7event.width);
              console.log("Old width: " + s7event.oldWidth);
           }
        });

このページ