Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti