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

CKTIS / HTML

srcset — lista de candidatos de imagen

El atributo `srcset` proporciona al navegador recursos de imagen alternativos. Los descriptores `x` indican la densidad de píxeles, mientras que los descriptores `w` indican el ancho del recurso, que se utiliza junto con `sizes` para seleccionar la imagen.

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

Sintaxis

srcset="image.png 1x, image@2x.png 2x" | srcset="image-400.png 400w, image-800.png 800w" sizes="100vw"

srcset es una lista de URL de imágenes separadas por comas y con descriptores opcionales. Se aplica a img y a source dentro de picture; en este último caso es obligatorio, y el elemento img siguiente muestra la imagen seleccionada. No sustituye a src en source dentro de audio o video.

El descriptor 2x indica la densidad, mientras que 800w indica el ancho intrínseco del recurso. Los valores deben ser positivos y no pueden repetirse. Si se omite el descriptor, significa 1x. No mezcles w con x ni con candidatos sin descriptor.

Con candidatos w, img requiere sizes; este describe el ancho para la selección, no el ancho de diseño CSS. En este caso, source también requiere sizes, salvo que el elemento img siguiente permita tamaños automáticos. Con w, el navegador ignora src al seleccionar; con x, puede proporcionar un candidato 1x si la lista no incluye ninguno.

El navegador selecciona un recurso según las condiciones de visualización; no des por sentado que existe una correspondencia fija con la densidad de pantalla. El ejemplo incorpora dos imágenes y mantiene el mismo aspecto independientemente de cuál se seleccione.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>srcset example</title>
<img
  src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%3E%3Cpath%20fill='royalblue'%20d='M0,0H40V40H0Z'/%3E%3C/svg%3E"
  srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%3E%3Cpath%20fill='royalblue'%20d='M0,0H40V40H0Z'/%3E%3C/svg%3E 1x, data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='80'%3E%3Cpath%20fill='royalblue'%20d='M0,0H80V80H0Z'/%3E%3C/svg%3E 2x"
  width="40" height="40" alt="Blue square">
</html>

Resultado

A royal-blue square displayed at 40 × 40 CSS pixels.

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