Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

imagesizes — tamaño de origen de la imagen para la precarga

El atributo imagesizes describe el ancho previsto de una imagen para que el navegador pueda elegir un recurso de imagesrcset durante la precarga. Se aplica a link con rel="preload" y as="image"; no establece el ancho de la imagen en el diseño.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

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

imagesizes proporciona el tamaño de origen que se usa al elegir una imagen de imagesrcset. Solo se permite en un elemento link con rel="preload" y as="image". Si imagesrcset contiene descriptores de ancho w, imagesizes es obligatorio.

Su valor es una lista de tamaños de origen, como sizes en una imagen: (max-width: 600px) 100vw, 50vw significa el ancho completo de la ventana gráfica hasta 600 píxeles CSS y, después, la mitad de ese ancho. Se aplica la primera condición que coincida; la última longitud es el valor alternativo. No se permiten porcentajes como longitudes de tamaño de origen.

Haz que imagesizes coincida con el sizes de la imagen de destino y imagesrcset con su srcset, para que ambas etapas seleccionen un recurso coherente. La declaración describe el ancho previsto, pero no lo establece: define el diseño por separado, por ejemplo, con CSS. No lo confundas con sizes del elemento link, que describe las dimensiones de los iconos.

El ejemplo usa dos variantes SVG incrustadas (80w y 160w), cada una con un rectángulo verde azulado, por lo que no hacen falta archivos aparte. Tanto imagesizes como sizes tienen un valor fijo de 80px, independientemente del ancho de la ventana gráfica. La consola confirma que los valores coinciden y muestra por separado el tamaño de origen de 80px y el ancho de 64px establecido mediante CSS para el diseño. El ejemplo no mide si la precarga acelera la descarga.

Ejemplos

<!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

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.

Fuentes