CKTIS / HTML
sizes — ancho para seleccionar imágenes y dimensiones de iconos
El atributo sizes tiene dos significados distintos: en img y source describe el ancho de imagen que se utiliza para seleccionar un recurso de srcset; en link declara las dimensiones disponibles de los iconos. No sustituye las reglas CSS que determinan el tamaño mostrado de la imagen.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
img/source: sizes="(media-condition) length, fallback-length" | sizes="auto, fallback-length"
link: sizes="16x16 32x32" | sizes="any"En img y en source dentro de picture, sizes describe el ancho previsto de la imagen en la maquetación. El navegador lo combina con candidatos de srcset que usan descriptores de ancho, como 640w, para seleccionar un recurso. Es una indicación para elegir un archivo, no una instrucción para cambiar las dimensiones CSS. No se usa para elegir entre candidatos con los descriptores 1x y 2x.
La lista se separa con comas, por ejemplo (max-width: 600px) 100vw, 50vw. La primera condición que se cumple proporciona el ancho; una longitud final sin condición sirve como alternativa. Las longitudes deben ser no negativas; se permiten unidades como px, em, vw y funciones matemáticas como calc(), pero no porcentajes. Si el análisis no encuentra un valor utilizable, devuelve 100vw.
En img, el uso de descriptores w requiere sizes. En source se aplica la misma regla, salvo que el img siguiente permita tamaños automáticos. Para usar sizes="auto", ese img debe tener loading="lazy" y su propio sizes debe ser auto o empezar por auto,. auto debe aparecer primero; después pueden añadirse valores alternativos. En ese caso, el ancho procede del tamaño de la imagen renderizada. Indica también las dimensiones mediante width y height o CSS. Si se omite sizes en un source anterior en este caso, equivale a auto.
En link, el significado es distinto: sizes indica de forma orientativa las dimensiones disponibles de los iconos y solo se permite cuando rel contiene icon o apple-touch-icon. El valor consta de tokens únicos separados por espacios, como 16x16 32x32, o de any para cualquier tamaño. Los pares indican ancho y alto en píxeles; los números son positivos, no llevan ceros iniciales y se separan con x o X. En los tokens no se distingue entre mayúsculas y minúsculas ASCII. Para precargar imágenes mediante link, el atributo correspondiente es imagesizes, no sizes.
El ejemplo incluye un SVG sin archivos externos. CSS establece las dimensiones reales, mientras que sizes="160px" describe el mismo ancho para seleccionar la fuente. Leer el atributo produce un texto predecible; no prueba el algoritmo de selección de recursos.
Ejemplos
<!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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.