预载图像 preload-image

预载图像是静态资产预览图像,在调用init()方法后立即加载,并在下载查看器SDK库、资产和预设信息时显示。 预加载图像的目的是为了从视觉上改善查看器的加载时间并快速向用户呈现内容。

预加载图像适用于最常见的查看器嵌入方法,即不受高度限制的响应式嵌入。 查看标题 高度不受限制的响应式设计嵌入.

但是,当使用其他嵌入方法或特定配置选项时,该功能有一定的限制。 在以下情况下,预加载图像可能无法正确呈现:

  • 当查看器的大小固定并且大小使用以下任一方式定义时: stagesize 查看器预设记录中的配置属性,或者在顶层查看器容器元素的外部查看器CSS文件中。
  • 使用宽度和高度定义的灵活尺寸嵌入查看器嵌入方法时。 查看标题 定义宽度和高度的灵活大小嵌入.

如果在上面列出的操作模式之一中使用查看器,请使用禁用预加载图像功能 preloadImage 配置属性。

此外,即使已在配置中启用预加载图像,也不使用预加载图像,前提是查看器嵌入到DOM元素中,并使用隐藏 display:none CSS设置或从DOM树分离。

recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8