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.