Image de préchargement preload-image
L’image de préchargement est une image d’aperçu de ressource statique qui se charge juste après avoir appelé la méthode init() et s’affiche pendant le téléchargement des bibliothèques du SDK de la visionneuse, des ressources et des informations de paramètre prédéfini. L’image de préchargement a pour but 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 correctement pour la méthode d’incorporation de visionneuses la plus courante, qui est l’incorporation réactive avec une hauteur illimitée. Voir l’en-tête Intégration de conception réactive avec une hauteur libre.
La fonctionnalité présente toutefois certaines limites lorsque d’autres méthodes d’incorporation ou des options de configuration spécifiques sont utilisées. Le rendu d’une image de préchargement peut échouer dans les cas suivants :
- Lorsque la visionneuse est fixe en taille et que la taille est définie à l’aide de l’attribut de configuration
stagesizedans l’enregistrement de paramètre prédéfini de la visionneuse. Vous pouvez également utiliser le fichier CSS de visionneuse externe pour l’élément de conteneur de visionneuse de niveau supérieur. - Lors de l’utilisation de l’incorporation de tailles flexibles avec la méthode d’incorporation de visionneuses définie en largeur et en hauteur. Voir l’en-tête Intégration de taille flexible avec largeur et hauteur définies.
Désactivez la fonction de préchargement d’image à l’aide de l’attribut de configuration preloadImage si vous utilisez la visionneuse dans l’un des modes d’opération 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 dans l’élément DOM est masquée à l’aide du paramètre CSS display:none ou détachée de l’arborescence DOM.