画像のプリロード

プリロード画像は、 init()メソッドを呼び出した直後に読み込まれ、ビューアSDKライブラリ、アセットおよびプリセット情報のダウンロード中に表示される静的なアセットプレビュー画像です。 プリロード画像の目的は、視覚的にビューアの読み込み時間を改善し、ユーザに対して迅速にコンテンツを提示することです。

プリロード画像は、最も一般的なビューア埋め込み方法(高さ無制限のレスポンシブ埋め込み)に適しています。 見出し高さ無制限のレスポンシブデザイン埋め込みを参照してください。

ただし、この機能には、他の埋め込み方法や特定の設定オプションを使用する場合に一定の制限があります。 次の場合に、イメージのプリロードが正しくレンダリングされない可能性があります。

  • ビューアのサイズを固定し、サイズを定義する場合は、ビューアプリセットレコード内のstagesize設定属性、またはトップレベルのビューアコンテナ要素の外部ビューアのCSSファイルを使用します。
  • ビューア埋め込みの幅と高さが定義されたフレキシブルサイズ埋め込みを使用する場合。 幅と高さを定義したフレキシブルサイズ埋め込みを参照してください。

上記のいずれかの操作モードでビューアを使用する場合は、 preloadImage設定属性を使用して、画像のプリロード機能を無効にする必要が生じる場合があります。

また、設定でビューアがDOM要素に埋め込まれている場合、CSS設定を使用して非表示になっているか、DOMツリーから切り離されている場合でも、プリロード画像は使用されません。display:none

このページ