Precarica immagine

L’immagine di precaricamento è un’immagine di anteprima statica di una risorsa che viene caricata subito dopo la chiamata al metodo init() e viene visualizzata durante il download delle librerie SDK del visualizzatore, delle risorse e delle informazioni sui predefiniti. Lo scopo dell’immagine di precaricamento è migliorare visivamente il tempo di caricamento del visualizzatore e presentare rapidamente il contenuto all’utente.

L’immagine di precaricamento funziona bene per il metodo di incorporamento più comune, ovvero l’incorporamento dinamico con altezza illimitata. Vedi il titolo Design reattivo con altezza illimitata.

La funzione, tuttavia, presenta alcune limitazioni quando si utilizzano altri metodi di incorporamento o opzioni di configurazione specifiche. Il rendering dell'immagine di precaricamento potrebbe non riuscire nei seguenti casi:

• Quando il visualizzatore è di dimensioni fisse e la dimensione viene definita utilizzando stagesize attributo di configurazione all’interno del record del predefinito visualizzatore. Oppure, utilizzando il file CSS del visualizzatore esterno per l’elemento contenitore del visualizzatore di primo livello.
• Quando utilizzi l’incorporamento di dimensioni flessibili con il metodo di incorporamento del visualizzatore definito dalla larghezza e dall’altezza. Vedi il titolo Dimensione flessibile che incorpora con larghezza e altezza definite.

Disattiva la funzione di precaricamento dell'immagine utilizzando preloadImage se utilizzi il visualizzatore in una delle modalità operative elencate sopra.

Inoltre, l’immagine di precaricamento non viene utilizzata, anche se abilitata nella configurazione, se il visualizzatore è incorporato nell’elemento DOM è nascosto tramite display:none Impostazione CSS o rimozione dalla struttura DOM.