Precarica immagine preload-image
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 l'intestazione Incorporamento 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 le dimensioni del visualizzatore sono fisse e vengono definite utilizzando l'attributo di configurazione
stagesizeall'interno del record del predefinito visualizzatore oppure nel 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 l'intestazione Dimensione flessibile con larghezza e altezza definite.
Se si utilizza il visualizzatore in una delle modalità operative elencate in precedenza, disattivare la funzione di precaricamento dell'immagine utilizzando l'attributo di configurazione preloadImage.
Inoltre, l'immagine di precaricamento non viene utilizzata, anche se abilitata nella configurazione, se il visualizzatore è incorporato nell'elemento DOM è nascosto utilizzando l'impostazione CSS display:none o scollegato dalla struttura DOM.