CKTIS / HTML
imagesizes — Bildquellgröße für das Vorladen
Das Attribut imagesizes beschreibt die erwartete Breite eines Bildes, damit der Browser beim Vorladen eine Ressource aus imagesrcset auswählen kann. Es gilt für link mit rel="preload" und as="image"; die Layoutbreite des Bildes wird dadurch nicht festgelegt.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<link rel="preload" as="image" imagesrcset="…" imagesizes="(max-width: 600px) 100vw, 50vw">imagesizes gibt die Quellgröße an, die bei der Auswahl eines Bildes aus imagesrcset verwendet wird. Es ist nur bei einem link-Element mit rel="preload" und as="image" zulässig. Enthält imagesrcset Breiten-Deskriptoren w, ist imagesizes erforderlich.
Der Wert ist eine Liste von Quellgrößen, ähnlich wie sizes bei einem Bild: (max-width: 600px) 100vw, 50vw bedeutet bis zu 600 CSS-Pixeln die gesamte Viewportbreite und danach die Hälfte davon. Es gilt die erste zutreffende Bedingung; die letzte Längenangabe dient als Standardwert. Prozentangaben sind als Längen für Quellgrößen nicht zulässig.
Stimme imagesizes auf das sizes des Zielbildes und imagesrcset auf dessen srcset ab, damit beide Schritte eine passende Ressource auswählen. Die Angabe beschreibt die erwartete Breite, legt sie aber nicht fest — das Layout wird separat bestimmt, zum Beispiel mit CSS. Verwechsle das Attribut auch nicht mit sizes am link-Element, das Icon-Abmessungen beschreibt.
Das Beispiel verwendet zwei eingebettete SVG-Varianten (80w und 160w) mit jeweils einem blaugrünen Rechteck. Separate Dateien sind daher nicht nötig. imagesizes und sizes haben beide den festen Wert 80px, unabhängig von der Viewportbreite. Die Konsole bestätigt, dass die Werte übereinstimmen, und gibt die Quellgröße von 80px getrennt von der per CSS festgelegten Layoutbreite von 64px aus. Das Beispiel misst nicht, ob das Vorladen den Download beschleunigt.
Beispiele
<!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>Ergebnis
Preload source size: 80px Preload and image source sizes match: true Image layout width: 64px
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.