Pré-carregar imagem

A imagem de pré-carregamento é uma imagem de visualização de ativo estático que é carregada logo após chamar o método init() e é exibida durante o download das bibliotecas, do ativo e das informações predefinidas do SDK do Visualizador. A finalidade da imagem de pré-carregamento é melhorar visualmente o tempo de carregamento do visualizador e apresentar conteúdo ao usuário rapidamente.

A imagem de pré-carregamento 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 de design responsivo 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 de pré-carregamento pode não ser renderizada corretamente nos seguintes casos:

• Quando o visualizador é fixado em tamanho e o tamanho é definido usando o atributo de configuração stagesize dentro do registro predefinido do visualizador ou, no arquivo CSS do visualizador externo para o elemento do contêiner do visualizador de nível superior.
• Ao usar a incorporação de tamanho flexível com o método de incorporação de largura e altura definido pelo 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, desative 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 ativada na configuração - se o visualizador estiver incorporado ao elemento DOM estiver oculto usando a configuração display:none CSS ou desconectado da árvore DOM.