L’image de préchargement est une image de prévisualisation de ressources statique qui se charge juste après avoir appelé la méthode init() et qui s’affiche pendant le téléchargement des bibliothèques du SDK de la visionneuse, des informations sur les ressources et les paramètres prédéfinis. L’objectif de l’image de préchargement est d’améliorer visuellement le temps de chargement de la visionneuse et de présenter rapidement le contenu à l’utilisateur.
L’image de préchargement fonctionne bien avec la méthode d’incorporation la plus courante de la visionneuse, qui consiste en une incorporation réactive avec une hauteur libre. Voir l'en-tête Incorporation de conception réactive avec une hauteur sans restriction.
Toutefois, cette fonction présente certaines limites lorsque d’autres méthodes d’incorporation ou des options de configuration spécifiques sont utilisées. Le rendu de l’image de préchargement peut échouer dans les cas suivants :
stagesize
dans l’enregistrement de paramètre prédéfini de la visionneuse ou dans le fichier CSS de la visionneuse externe pour l’élément de conteneur de la visionneuse de niveau supérieur.Vous devrez peut-être désactiver la fonction d’image de préchargement à l’aide de l’attribut de configuration preloadImage
si vous utilisez la visionneuse dans l’un des modes de fonctionnement répertoriés ci-dessus.
En outre, l’image de préchargement n’est pas utilisée, même si elle est activée dans la configuration, si la visionneuse est incorporée à l’élément DOM est masquée à l’aide du paramètre CSS display:none
ou détachée de l’arborescence DOM.