Pré-carregar imagem preload-image
A imagem pré-carregada é uma imagem de pré-visualização de ativo estático que é carregada logo após chamar o método init() e é exibida enquanto as bibliotecas, o ativo e as informações predefinidas do SDK do Visualizador são baixados. O objetivo do pré-carregamento da imagem é melhorar visualmente o tempo de carregamento do visualizador e apresentar conteúdo ao usuário rapidamente.
O pré-carregamento de imagens funciona bem para o método de incorporação do visualizador mais comum, que é a incorporação responsiva com altura irrestrita. Consulte o cabeçalho Incorporação responsiva de design com altura irrestrita.
No entanto, o recurso tem determinadas limitações quando outros métodos de incorporação ou opções de configuração específicas são usados. A imagem pré-carregada pode não ser renderizada corretamente nos seguintes casos:
- Quando o visualizador é fixo em tamanho e o tamanho é definido usando o atributo de configuração
stagesizedentro do registro de predefinição do visualizador ou no arquivo CSS do visualizador externo para o elemento de contêiner do visualizador de nível superior. - Ao usar a incorporação de tamanho flexível com o método definido por largura e altura da incorporação do visualizador. Consulte o cabeçalho Incorporação de tamanho flexível com largura e altura definidas.
Se você usar o visualizador em um dos modos de operação listados acima, desabilite o recurso de pré-carregamento de imagem usando o atributo de configuração preloadImage.
Além disso, a imagem de pré-carregamento não é usada, mesmo se habilitada na configuração, se o visualizador estiver incorporado no elemento DOM estiver oculto usando a configuração CSS display:none ou desanexado da árvore DOM.