WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

sizes — Bildbreite für die Quellenauswahl und Symbolgrößen

Das Attribut sizes hat zwei unterschiedliche Bedeutungen: Bei img und source beschreibt es die Bildbreite, die zur Auswahl einer Ressource aus srcset verwendet wird; bei link gibt es verfügbare Symbolgrößen an. Es ersetzt keine CSS-Regeln, die die angezeigte Bildgröße festlegen.

Version: 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"

Bei img und bei source innerhalb von picture beschreibt sizes die vorgesehene Layoutbreite des Bildes. Der Browser verwendet sie zusammen mit srcset-Kandidaten mit Breiten-Deskriptoren wie 640w, um eine Ressource auszuwählen. Das Attribut ist ein Hinweis zur Dateiauswahl und keine Anweisung, CSS-Abmessungen zu ändern. Es dient nicht zur Auswahl zwischen Kandidaten mit den Deskriptoren 1x und 2x.

Die Liste ist durch Kommas getrennt, zum Beispiel (max-width: 600px) 100vw, 50vw. Die Breite ergibt sich aus der ersten zutreffenden Bedingung; eine abschließende Länge ohne Bedingung dient als Ersatzwert. Längen dürfen nicht negativ sein; Einheiten wie px, em, vw und mathematische Funktionen wie calc() sind zulässig, Prozentwerte jedoch nicht. Findet der Parser keinen verwendbaren Wert, ergibt sich 100vw.

Bei img setzt die Verwendung von w-Deskriptoren sizes voraus. Bei source gilt dieselbe Regel, außer das nachfolgende img erlaubt automatische Größen. Für sizes="auto" muss dieses img loading="lazy" haben und sein eigenes sizes muss auto sein oder mit auto, beginnen. auto muss an erster Stelle stehen; Ersatzwerte können folgen. Die Breite stammt dann aus der Größe des gerenderten Bildes. Gib außerdem die Abmessungen über width und height oder CSS an. Wird bei einem vorangehenden source in diesem Fall sizes weggelassen, entspricht das auto.

Bei link hat das Attribut eine andere Bedeutung: sizes gibt als Hinweis verfügbare Symbolgrößen an und ist nur zulässig, wenn rel icon oder apple-touch-icon enthält. Der Wert besteht aus eindeutigen, durch Leerzeichen getrennten Tokens, etwa 16x16 32x32, oder aus any für beliebige Größen. Die Zahlenpaare geben Breite und Höhe in Pixeln an; die Zahlen sind positiv und haben keine führenden Nullen. Getrennt werden sie durch x oder X. Bei den Tokens wird die ASCII-Groß- und Kleinschreibung nicht unterschieden. Zum Vorladen von Bildern über link ist das passende Attribut imagesizes, nicht sizes.

Das Beispiel enthält ein SVG und benötigt keine externen Dateien. CSS legt die tatsächlichen Abmessungen fest, während sizes="160px" dieselbe Breite für die Quellenauswahl beschreibt. Das Auslesen des Attributs erzeugt einen vorhersehbaren Text, testet aber nicht den Algorithmus zur Ressourcenauswahl.

Beispiele

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

Ergebnis

sizes=160px

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.

Quellen