WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

srcset — Liste der Bildkandidaten

Das Attribut `srcset` stellt dem Browser alternative Bildressourcen bereit. `x`-Deskriptoren geben die Pixeldichte an, `w`-Deskriptoren die Ressourcenbreite, die zusammen mit `sizes` für die Bildauswahl verwendet wird.

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

Syntax

srcset="image.png 1x, image@2x.png 2x" | srcset="image-400.png 400w, image-800.png 800w" sizes="100vw"

srcset ist eine durch Kommas getrennte Liste von Bild-URLs mit optionalen Deskriptoren. Es gilt für img sowie für source innerhalb von picture; dort ist es erforderlich, und das nachfolgende img zeigt das ausgewählte Bild an. Es ersetzt nicht src bei source in audio oder video.

Der Deskriptor 2x bezeichnet die Pixeldichte, 800w die natürliche Breite der Ressource. Werte müssen positiv sein und dürfen nicht wiederholt werden. Ein fehlender Deskriptor bedeutet 1x. Mische w nicht mit x oder mit Kandidaten ohne Deskriptor.

Bei w-Kandidaten ist sizes für img erforderlich; es beschreibt die Breite für die Auswahl, nicht die CSS-Layoutbreite. Auch ein source benötigt in diesem Fall sizes, außer das nachfolgende img erlaubt automatische Größen. Bei w ignoriert der Browser src für die Auswahl; bei x kann src einen 1x-Kandidaten bereitstellen, falls die Liste keinen enthält.

Der Browser wählt eine Ressource entsprechend den Anzeige­bedingungen aus; gehe nicht von einer festen Zuordnung zur Bildschirmdichte aus. Das Beispiel bettet zwei Bilder ein und sieht unabhängig von der Auswahl gleich aus.

Beispiele

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>srcset example</title>
<img
  src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%3E%3Cpath%20fill='royalblue'%20d='M0,0H40V40H0Z'/%3E%3C/svg%3E"
  srcset="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='40'%20height='40'%3E%3Cpath%20fill='royalblue'%20d='M0,0H40V40H0Z'/%3E%3C/svg%3E 1x, data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='80'%20height='80'%3E%3Cpath%20fill='royalblue'%20d='M0,0H80V80H0Z'/%3E%3C/svg%3E 2x"
  width="40" height="40" alt="Blue square">
</html>

Ergebnis

A royal-blue square displayed at 40 × 40 CSS pixels.

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