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 tamanho do visualizador é fixo e o tamanho é definido usando stagesize atributo de configuração dentro 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, desative o recurso de pré-carregamento de imagem usando o preloadImage atributo de configuração.

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 display:none Configuração de CSS ou desanexado da árvore DOM.

recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8