CKTIS / HTML
imagesizes — dimensione della sorgente dell’immagine per il precaricamento
L’attributo imagesizes descrive la larghezza prevista di un’immagine, così il browser può scegliere una risorsa da imagesrcset durante il precaricamento. Si applica a link con rel="preload" e as="image"; non imposta la larghezza dell’immagine nel layout.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<link rel="preload" as="image" imagesrcset="…" imagesizes="(max-width: 600px) 100vw, 50vw">imagesizes fornisce la dimensione della sorgente usata per selezionare un’immagine da imagesrcset. È consentito solo su un elemento link con rel="preload" e as="image". Se imagesrcset contiene descrittori di larghezza w, imagesizes è obbligatorio.
Il valore è un elenco di dimensioni della sorgente, come sizes di un’immagine: (max-width: 600px) 100vw, 50vw indica l’intera larghezza dell’area visibile fino a 600 pixel CSS e poi metà di tale larghezza. Si applica la prima condizione corrispondente; l’ultima lunghezza è il valore predefinito. Le percentuali non sono ammesse come lunghezze della dimensione della sorgente.
Fai corrispondere imagesizes al sizes dell’immagine di destinazione e imagesrcset al suo srcset, così entrambe le fasi selezionano una risorsa coerente. La dichiarazione descrive la larghezza prevista, ma non la imposta: definisci il layout separatamente, per esempio con CSS. Non confonderla con sizes dell’elemento link, che descrive le dimensioni delle icone.
L’esempio usa due varianti SVG incorporate (80w e 160w), ciascuna con un rettangolo verde petrolio, quindi non servono file separati. Sia imagesizes sia sizes hanno il valore fisso di 80px, indipendentemente dalla larghezza dell’area visibile. La console conferma che i valori coincidono e mostra separatamente la dimensione della sorgente di 80px e la larghezza nel layout di 64px, impostata tramite CSS. L’esempio non misura se il precaricamento velocizza il download.
Esempi
<!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>Risultato
Preload source size: 80px Preload and image source sizes match: true Image layout width: 64px
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.