Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

imagesizes — tamanho da origem da imagem para pré-carregamento

O atributo imagesizes descreve a largura prevista de uma imagem para que o navegador possa escolher um recurso de imagesrcset durante o pré-carregamento. Aplica-se a link com rel="preload" e as="image"; não define a largura da imagem no esquema da página.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

<link rel="preload" as="image" imagesrcset="…" imagesizes="(max-width: 600px) 100vw, 50vw">

imagesizes indica o tamanho da origem usado para escolher uma imagem de imagesrcset. Só é permitido num elemento link com rel="preload" e as="image". Se imagesrcset contiver descritores de largura w, imagesizes é obrigatório.

O valor é uma lista de tamanhos da origem, tal como sizes numa imagem: (max-width: 600px) 100vw, 50vw significa a largura total da área de visualização até 600 píxeis CSS e, depois, metade dessa largura. Aplica-se a primeira condição correspondente; o último comprimento é o valor predefinido. As percentagens não são permitidas como comprimentos de tamanho da origem.

Faça corresponder imagesizes ao sizes da imagem de destino e imagesrcset ao respetivo srcset, para que ambas as etapas selecionem um recurso coerente. A declaração descreve a largura prevista, mas não a define — configure o esquema separadamente, por exemplo, com CSS. Não a confunda com sizes do elemento link, que descreve as dimensões dos ícones.

O exemplo utiliza duas variantes SVG incorporadas (80w e 160w), cada uma com um retângulo verde-azulado, pelo que não são necessários ficheiros separados. Tanto imagesizes como sizes têm o valor fixo de 80px, independentemente da largura da área de visualização. A consola confirma que os valores coincidem e apresenta em separado o tamanho da origem de 80px e a largura de 64px definida em CSS para o esquema da página. O exemplo não mede se o pré-carregamento acelera a transferência.

Exemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Source size for image preloading</title>
  <link id="preload" rel="preload" as="image" imagesizes="80px"
        imagesrcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='40'%3E%3Crect%20width='80'%20height='40'%20fill='teal'/%3E%3C/svg%3E 80w,
                     data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='80'%3E%3Crect%20width='160'%20height='80'%20fill='teal'/%3E%3C/svg%3E 160w">
  <style>
    #sample { display: block; width: 64px; height: auto; }
  </style>
</head>
<body>
  <h1>Preload source size and layout width</h1>
  <img id="sample" alt="Teal rectangle" width="80" height="40" sizes="80px"
       src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='40'%3E%3Crect%20width='80'%20height='40'%20fill='teal'/%3E%3C/svg%3E"
       srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='40'%3E%3Crect%20width='80'%20height='40'%20fill='teal'/%3E%3C/svg%3E 80w,
               data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='80'%3E%3Crect%20width='160'%20height='80'%20fill='teal'/%3E%3C/svg%3E 160w">
  <script>
    const preload = document.getElementById('preload');
    const image = document.getElementById('sample');
    if ('imageSizes' in preload) {
      console.log(`Preload source size: ${preload.imageSizes}`);
      console.log(`Preload and image source sizes match: ${preload.imageSizes === image.sizes}`);
      console.log(`Image layout width: ${getComputedStyle(image).width}`);
    } else {
      console.log('imagesizes reflection is unsupported');
    }
  </script>
</body>
</html>

Resultado

Preload source size: 80px
Preload and image source sizes match: true
Image layout width: 64px

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes