预加载图像是一种静态资产预览图像,它在调用init()方法后直接加载,并在下载查看器SDK库、资产和预设信息时显示。 预加载图像的目的是直观地缩短查看者加载时间并快速向用户呈现内容。
预加载图像非常适合于最常用的查看器嵌入方法,即具有无限制高度的响应嵌入。 请参阅标题具有不受限高度的响应式设计嵌入。
但是,当使用其他嵌入方法或特定配置选项时,该功能存在某些限制。 在以下情况下,预加载图像可能无法正确呈现:
stagesize
配置属性定义的,或者在顶级查看器容器元素的外部查看器CSS文件中定义的。如果在上面列出的操作模式之一中使用查看器,请使用preloadImage
配置属性禁用预加载图像功能。
此外,即使在配置中启用了预加载图像,也不会使用预加载图像 — 如果查看器已嵌入到DOM元素中,则会使用display:none
CSS设置进行隐藏,或从DOM树中分离查看器。