KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

sizes — afbeeldingsbreedte voor bronselectie en pictogramafmetingen

Het attribuut sizes heeft twee verschillende betekenissen: op img en source beschrijft het de afbeeldingsbreedte die wordt gebruikt om een bron uit srcset te kiezen; op link geeft het beschikbare pictogramafmetingen aan. Het vervangt geen CSS-regels die de weergegeven afbeeldingsgrootte bepalen.

Versie: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

img/source: sizes="(media-condition) length, fallback-length" | sizes="auto, fallback-length"
link: sizes="16x16 32x32" | sizes="any"

Op img en op source binnen picture beschrijft sizes de beoogde breedte van de afbeelding in de lay-out. De browser combineert deze met kandidaten van srcset met breedtedescriptoren, zoals 640w, om een bron te kiezen. Het is een aanwijzing voor bestandsselectie, geen opdracht om CSS-afmetingen te wijzigen. Het wordt niet gebruikt om te kiezen tussen kandidaten met de descriptoren 1x en 2x.

De lijst is kommagescheiden, bijvoorbeeld (max-width: 600px) 100vw, 50vw. De eerste overeenkomende voorwaarde levert de breedte; een laatste lengte zonder voorwaarde dient als terugvalwaarde. Lengtes moeten niet-negatief zijn; eenheden zoals px, em, vw en wiskundige functies zoals calc() zijn toegestaan, maar percentages niet. Als de parser geen bruikbare waarde vindt, levert deze 100vw op.

Op img is sizes vereist wanneer w-descriptoren worden gebruikt. Op source geldt dezelfde regel, tenzij de eropvolgende img automatische afmetingen toestaat. Voor sizes="auto" moet deze img loading="lazy" hebben en moet het eigen sizes gelijk zijn aan auto of beginnen met auto,. auto moet vooraan staan; daarna mogen terugvalwaarden volgen. De breedte wordt dan bepaald door de gerenderde afbeeldingsgrootte. Geef de afmetingen ook op met width en height of CSS. In dit geval is het weglaten van sizes op een voorafgaande source gelijk aan auto.

Op link betekent het iets anders: sizes geeft als aanwijzing beschikbare pictogramafmetingen op en is alleen toegestaan wanneer rel icon of apple-touch-icon bevat. De waarde bestaat uit unieke, door spaties gescheiden tokens, zoals 16x16 32x32, of uit any voor willekeurige afmetingen. De paren geven breedte en hoogte in pixels aan; de getallen zijn positief en hebben geen voorloopnullen, met x of X als scheidingsteken. Bij tokens wordt geen onderscheid gemaakt tussen ASCII-hoofdletters en kleine letters. Voor het vooraf laden van afbeeldingen met link is imagesizes het overeenkomstige attribuut, niet sizes.

Het voorbeeld bevat een SVG en heeft geen externe bestanden nodig. CSS bepaalt de werkelijke afmetingen, terwijl sizes="160px" dezelfde breedte voor de bronselectie beschrijft. Het uitlezen van het attribuut levert voorspelbare tekst op, maar test het algoritme voor bronselectie niet.

Voorbeelden

<!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>

Resultaat

sizes=160px

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.

Bronnen