CKTIS / HTML
imagesizes — rozmiar obrazu przy wstępnym ładowaniu
Atrybut imagesizes opisuje przewidywaną szerokość obrazu, aby przeglądarka mogła wybrać zasób z imagesrcset podczas wstępnego ładowania. Dotyczy elementu link z rel="preload" i as="image"; nie ustawia szerokości obrazu w układzie strony.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<link rel="preload" as="image" imagesrcset="…" imagesizes="(max-width: 600px) 100vw, 50vw">imagesizes podaje rozmiar źródłowy używany przy wyborze obrazu z imagesrcset. Można go stosować wyłącznie na elemencie link z rel="preload" i as="image". Gdy imagesrcset zawiera deskryptory szerokości w, obecność imagesizes jest obowiązkowa.
Wartością jest lista rozmiarów źródłowych, podobnie jak w sizes obrazu: (max-width: 600px) 100vw, 50vw oznacza pełną szerokość obszaru widoku do 600 pikseli CSS, a następnie połowę tej szerokości. Obowiązuje pierwszy pasujący warunek; ostatnia długość stanowi wartość domyślną. Procenty nie są dozwolone jako długości rozmiaru źródłowego.
Dobierz imagesizes do sizes docelowego obrazu, a imagesrcset do jego srcset, aby oba etapy wybierały zgodny zasób. Deklaracja opisuje przewidywaną szerokość, lecz jej nie ustawia — układ określa się osobno, np. w CSS. Nie należy też mylić jej z sizes elementu link, które opisuje wymiary ikon.
Przykład zawiera dwa osadzone warianty SVG (80w i 160w), każdy z prostokątem w kolorze morskim, więc nie wymaga osobnych plików. Zarówno imagesizes, jak i sizes mają stałą wartość 80px, niezależną od szerokości obszaru widoku. Konsola potwierdza zgodność tych wartości i wyświetla osobno rozmiar źródłowy 80px oraz szerokość obrazu w układzie, ustawioną w CSS na 64px. Przykład nie mierzy przyspieszenia pobierania.
Przykłady
<!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>Wynik
Preload source size: 80px Preload and image source sizes match: true Image layout width: 64px
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.