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

CKTIS / HTML

sizes — largura para seleção de imagens e dimensões de ícones

O atributo sizes tem dois significados distintos: em img e source, descreve a largura da imagem usada para selecionar um recurso de srcset; em link, declara as dimensões disponíveis dos ícones. Não substitui as regras CSS que determinam o tamanho apresentado da imagem.

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

Sintaxe

img/source: sizes="(media-condition) length, fallback-length" | sizes="auto, fallback-length"
link: sizes="16x16 32x32" | sizes="any"

Em img e em source dentro de picture, sizes descreve a largura prevista da imagem na disposição. O browser combina-a com candidatos de srcset que usam descritores de largura, como 640w, para selecionar um recurso. É uma indicação para escolher um ficheiro, não uma instrução para alterar as dimensões CSS. Não é usado para escolher entre candidatos com os descritores 1x e 2x.

A lista é separada por vírgulas, por exemplo (max-width: 600px) 100vw, 50vw. A primeira condição correspondente fornece a largura; um comprimento final sem condição serve de alternativa. Os comprimentos têm de ser não negativos; são permitidas unidades como px, em, vw e funções matemáticas como calc(), mas não percentagens. Se a análise não encontrar um valor utilizável, devolve 100vw.

Em img, a utilização de descritores w requer sizes. Em source, aplica-se a mesma regra, exceto se o img seguinte permitir tamanhos automáticos. Para usar sizes="auto", esse img tem de ter loading="lazy" e o seu próprio sizes tem de ser auto ou começar por auto,. auto tem de aparecer primeiro; podem seguir-se valores alternativos. Nesse caso, a largura provém do tamanho da imagem renderizada. Indica também as dimensões através de width e height ou de CSS. Neste caso, omitir sizes num source anterior equivale a auto.

Em link, o significado é diferente: sizes indica, a título informativo, as dimensões disponíveis dos ícones e só é permitido quando rel contém icon ou apple-touch-icon. O valor é composto por tokens únicos separados por espaços, como 16x16 32x32, ou por any para qualquer tamanho. Os pares indicam a largura e a altura em píxeis; os números são positivos, sem zeros à esquerda, e separados por x ou X. Os tokens não distinguem maiúsculas de minúsculas ASCII. Para pré-carregar imagens através de link, o atributo correspondente é imagesizes, não sizes.

O exemplo inclui um SVG sem ficheiros externos. CSS define as dimensões reais, enquanto sizes="160px" descreve a mesma largura para selecionar a origem. A leitura do atributo produz texto previsível; não testa o algoritmo de seleção de recursos.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>sizes</title>
<style>img { display: block; width: 160px; height: 80px; }</style>
<img id="sample" alt="Blue rectangle" width="160" height="80"
     sizes="160px"
     srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='80'%3E%3Cpath%20fill='blue'%20d='M0,0H160V80H0Z'/%3E%3C/svg%3E 160w">
<pre id="result"></pre>
<script>
  document.getElementById('result').textContent =
    'sizes=' + document.getElementById('sample').getAttribute('sizes');
</script>
</html>

Resultado

sizes=160px

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