CKTIS / HTML
sizes — larghezza per la selezione delle immagini e dimensioni delle icone
L’attributo sizes ha due significati distinti: su img e source descrive la larghezza dell’immagine usata per selezionare una risorsa da srcset; su link dichiara le dimensioni disponibili delle icone. Non sostituisce le regole CSS che determinano le dimensioni dell’immagine visualizzata.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
img/source: sizes="(media-condition) length, fallback-length" | sizes="auto, fallback-length"
link: sizes="16x16 32x32" | sizes="any"Su img e su source all’interno di picture, sizes descrive la larghezza prevista dell’immagine nel layout. Il browser la combina con i candidati di srcset che usano descrittori di larghezza, come 640w, per selezionare una risorsa. È un’indicazione per scegliere il file, non un’istruzione per modificare le dimensioni CSS. Non si usa per scegliere tra candidati con i descrittori 1x e 2x.
L’elenco è separato da virgole, per esempio (max-width: 600px) 100vw, 50vw. La prima condizione corrispondente fornisce la larghezza; una lunghezza finale senza condizione funge da valore di riserva. Le lunghezze devono essere non negative; sono ammesse unità come px, em, vw e funzioni matematiche come calc(), ma non le percentuali. Se l’analisi non trova un valore utilizzabile, restituisce 100vw.
Su img, l’uso dei descrittori w richiede sizes. Su source vale la stessa regola, a meno che il successivo img non consenta dimensioni automatiche. Per usare sizes="auto", questo img deve avere loading="lazy" e il suo sizes deve essere auto o iniziare con auto,. auto deve essere il primo valore; possono seguire valori di riserva. La larghezza deriva quindi dalle dimensioni dell’immagine renderizzata. Specifica anche le dimensioni tramite width e height o CSS. In questo caso, omettere sizes su un source precedente equivale a auto.
Su link, il significato è diverso: sizes indica a titolo informativo le dimensioni disponibili delle icone ed è consentito solo se rel contiene icon o apple-touch-icon. Il valore è composto da token unici separati da spazi, come 16x16 32x32, oppure da any per qualsiasi dimensione. Le coppie indicano larghezza e altezza in pixel; i numeri sono positivi, senza zeri iniziali, e separati da x o X. Nei token non si distingue tra maiuscole e minuscole ASCII. Per precaricare immagini tramite link, l’attributo corrispondente è imagesizes, non sizes.
L’esempio incorpora un SVG senza file esterni. CSS imposta le dimensioni effettive, mentre sizes="160px" descrive la stessa larghezza per la selezione della risorsa. Leggere l’attributo produce un testo prevedibile, ma non verifica l’algoritmo di selezione delle risorse.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>sizes</title>
<style>img { display: block; width: 160px; height: 80px; }</style>
<img id="sample" alt="Blue rectangle" width="160" height="80"
sizes="160px"
srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='80'%3E%3Cpath%20fill='blue'%20d='M0,0H160V80H0Z'/%3E%3C/svg%3E 160w">
<pre id="result"></pre>
<script>
document.getElementById('result').textContent =
'sizes=' + document.getElementById('sample').getAttribute('sizes');
</script>
</html>Risultato
sizes=160px
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.