Precargar imagen preload-image
La imagen de precarga es una imagen de vista previa de recursos estáticos que se carga justo después de llamar al método init() y se muestra mientras se descargan las bibliotecas, los recursos y la información de ajustes preestablecidos del SDK del visualizador. El propósito de la imagen de precarga es mejorar visualmente el tiempo de carga del visualizador y presentar contenido al usuario rápidamente.
La imagen de precarga funciona bien para el método de incrustación de visor más común, que es la incrustación adaptable con altura sin restricciones. Ver el encabezado Diseño interactivo incrustado con altura sin restricciones.
Sin embargo, la función tiene ciertas limitaciones cuando se utilizan otros métodos de incrustación u opciones de configuración específicas. La imagen de precarga puede no procesarse correctamente en los siguientes casos:
- Cuando el visor tiene un tamaño fijo y el tamaño se define mediante el atributo de configuración
stagesize
dentro del registro de ajustes preestablecidos del visor o en el archivo CSS del visor externo para el elemento contenedor del visor de nivel superior. - Al utilizar la incrustación de tamaño flexible con el método definido de anchura y altura de incrustación del visualizador. Ver el encabezado Tamaño flexible incrustado con la anchura y la altura definidas.
Si usa el visor en uno de los modos de operación enumerados arriba, deshabilite la característica de imagen de precarga usando el atributo de configuración preloadImage
.
Además, la imagen de precarga no se utiliza (aunque esté habilitada en la configuración) si el visor está incrustado en el elemento DOM, está oculto mediante la configuración CSS display:none
o se ha separado del árbol DOM.