CKTIS / HTML
imagesizes — bronafmeting van de afbeelding voor preload
Het attribuut imagesizes beschrijft de verwachte breedte van een afbeelding, zodat de browser tijdens het preloaden een bron uit imagesrcset kan kiezen. Het geldt voor link met rel="preload" en as="image"; het stelt de layoutbreedte van de afbeelding niet in.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<link rel="preload" as="image" imagesrcset="…" imagesizes="(max-width: 600px) 100vw, 50vw">imagesizes geeft de bronafmeting op die wordt gebruikt om een afbeelding uit imagesrcset te kiezen. Het is alleen toegestaan op een link-element met rel="preload" en as="image". Als imagesrcset breedtedescriptors w bevat, is imagesizes verplicht.
De waarde is een lijst met bronafmetingen, vergelijkbaar met sizes voor een afbeelding: (max-width: 600px) 100vw, 50vw betekent de volledige viewportbreedte tot 600 CSS-pixels en daarna de helft daarvan. De eerste overeenkomende voorwaarde geldt; de laatste lengte is de terugvalwaarde. Percentages zijn niet toegestaan als lengtes voor bronafmetingen.
Laat imagesizes overeenkomen met de sizes van de doelafbeelding en imagesrcset met de srcset ervan, zodat beide stappen een overeenkomstige bron kiezen. De declaratie beschrijft de verwachte breedte, maar stelt die niet in — bepaal de layout afzonderlijk, bijvoorbeeld met CSS. Verwar dit attribuut ook niet met sizes van het link-element, dat de afmetingen van pictogrammen beschrijft.
Het voorbeeld gebruikt twee ingebedde SVG-varianten (80w en 160w), elk met een blauwgroene rechthoek. Aparte bestanden zijn dus niet nodig. imagesizes en sizes hebben allebei de vaste waarde 80px, ongeacht de viewportbreedte. De console bevestigt dat die waarden overeenkomen en toont de bronafmeting van 80px apart van de via CSS ingestelde layoutbreedte van 64px. Het voorbeeld meet niet of preloaden het downloaden versnelt.
Voorbeelden
<!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>Resultaat
Preload source size: 80px Preload and image source sizes match: true Image layout width: 64px
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.