Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

srcset — elenco di candidati immagine

L’attributo `srcset` fornisce al browser risorse immagine alternative. I descrittori `x` indicano la densità di pixel, mentre i descrittori `w` indicano la larghezza della risorsa, usata insieme a `sizes` per selezionare l’immagine.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

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

srcset è un elenco di URL di immagini separati da virgole, con descrittori facoltativi. Si applica a img e a source all’interno di picture; in quest’ultimo caso è obbligatorio e l’elemento img seguente mostra l’immagine selezionata. Non sostituisce src su source in audio o video.

Il descrittore 2x indica la densità, mentre 800w indica la larghezza naturale della risorsa. I valori devono essere positivi e non devono ripetersi. Se il descrittore è omesso, significa 1x. Non mescolare w con x o con candidati senza descrittore.

Con i candidati w, img richiede sizes; questo descrive la larghezza usata per la selezione, non la larghezza del layout CSS. In questo caso anche source richiede sizes, a meno che l’elemento img seguente non consenta dimensioni automatiche. Con w, il browser ignora src nella selezione; con x, può fornire un candidato 1x se l’elenco non ne contiene uno.

Il browser seleziona una risorsa in base alle condizioni di visualizzazione; non presumere una corrispondenza fissa con la densità dello schermo. L’esempio incorpora due immagini e mantiene lo stesso aspetto indipendentemente dalla selezione.

Esempi

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

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti