WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

image-set(): Alternativen für ein Bild

Biete Bildkandidaten mit Auflösung und optionaler Typangabe an, damit der Browser eine nutzbare Quelle wählen kann.

Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

background-image: image-set(url("small.png") 1x, url("large.png") 2x);

image-set() beschreibt Alternativen für ein einzelnes Bild; es legt keine mehreren Hintergrundebenen übereinander. Jeder Kandidat kann eine Auflösung wie 1x oder 2x und einen MIME-Typhinweis mit type() enthalten. Der Browser wählt anhand unterstützter Formate, Anzeigeeigenschaften und eigener Regeln. Ein bestimmtes Verhältnis von Geräte- zu CSS-Pixeln garantiert daher nicht bedingungslos die Auswahl einer bestimmten Datei.

Mit type() kann der Browser ein nicht unterstütztes Format vor dem Laden verwerfen. Die Angabe konvertiert die Datei nicht, erzwingt keinen Decoder und garantiert nicht, dass die Bytes zur Bezeichnung passen. Wenn ältere Browser berücksichtigt werden müssen, setze vor image-set() eine normale background-image-Deklaration. Verschachtelte image-set()-Funktionen sind nicht zulässig.

Das Beispiel verwendet zwei erzeugte Verlaufsbilder. Den roten Kandidaten kennzeichnet es absichtlich mit einem nicht unterstützten MIME-Typ, den blauen mit image/png; beide haben 1x. Diese Kennzeichnung macht aus dem Verlauf keine PNG-Datei. Der gemessene blaue Pixel beweist, dass der nicht unterstützte Kandidat ausgefiltert wurde. Es findet kein Netzwerkdownload statt, und der Test misst nicht die Auswahl bei hoher Pixeldichte.

Beispiele

const sample=async style=>{const svg='<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8"><rect width="8" height="8" fill="white"/><foreignObject width="8" height="8"><div xmlns="http://www.w3.org/1999/xhtml" style="width:8px;height:8px;'+style.replaceAll('&','&amp;').replaceAll('"','&quot;')+'"></div></foreignObject></svg>';const image=new Image();image.src='data:image/svg+xml;charset=utf-8,'+encodeURIComponent(svg);await image.decode();const canvas=document.createElement('canvas');canvas.width=canvas.height=8;const context=canvas.getContext('2d');context.drawImage(image,0,0);return [...context.getImageData(4,4,1,1).data].slice(0,3).join(',')};
const filtered="image-set(linear-gradient(red,red) 1x type('image/x-cktis-unsupported'), linear-gradient(blue,blue) 1x type('image/png'))";
const supported=CSS.supports('background-image',filtered);
const pixel=await sample('background-image:'+filtered);
const nested=CSS.supports('background-image','image-set(image-set(url(test.png) 1x) 1x)');
console.log('supported='+supported+'; filtered-pixel='+pixel+'; nested='+nested);

Ergebnis

supported=true; filtered-pixel=0,0,255; nested=false

Beide Kandidaten haben dieselbe Auflösung. Das Ergebnis isoliert die MIME-Filterung, statt die bevorzugte Pixeldichte des Browsers zu erraten.

Quellen