Preload image is a static asset preview image which loads right after calling init() method and shows while Viewer SDK libraries, asset, and preset information is downloaded. The purpose of the preload image is to visually improve viewer load time and present content to the user quickly.
Preload image works well for the most common viewer embedding method, which is responsive embedding with unrestricted height. See the heading Responsive design embedding with unrestricted height.
The feature, however, has certain limitations when other embedding methods or specific configuration options are used. Preload image may fail to render properly in following cases:
stagesizeconfiguration attribute inside the viewer preset record. Or, using the external viewer CSS file for the top-level viewer container element.
Disable preload image feature using the
preloadImage configuration attribute if you are using the viewer in one of the operation modes listed above.
Also, preload image is not used-even if enabled in the configuration-if the viewer is embedded into the DOM element is hidden using
display:none CSS setting or detached from the DOM tree.