KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / CSS

image-set(): alternatieven voor één afbeelding

Bied afbeeldingskandidaten met resolutie en optionele type-informatie aan, zodat de browser een bruikbare bron kan kiezen.

Versie: 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() beschrijft alternatieven voor één afbeelding; het stapelt geen meerdere achtergrondlagen. Elke kandidaat kan een resolutie zoals 1x of 2x en een MIME-aanwijzing via type() bevatten. De browser kiest op basis van ondersteunde formaten, schermeigenschappen en eigen selectieregels. Een bepaalde verhouding tussen apparaatpixels en CSS-pixels garandeert dus niet zonder meer dat een specifiek bestand wordt gekozen.

Met type() kan de browser een niet-ondersteund formaat vóór het laden uitsluiten. Het converteert het bestand niet, dwingt geen decoder af en garandeert niet dat de bytes met het label overeenkomen. Zet er een gewone background-image-declaratie voor als een terugval voor browsers zonder deze syntax nodig is. Geneste image-set()-functies zijn niet toegestaan.

Het voorbeeld gebruikt twee gegenereerde verloopafbeeldingen. De rode kandidaat krijgt bewust een niet-ondersteund MIME-type en de blauwe image/png, beide met 1x; dat label verandert het verloop niet in een PNG-bestand. De gemeten blauwe pixel bevestigt dat de onbruikbare kandidaat is weggefilterd. Er is geen netwerkdownload en de test meet niet de selectie voor schermen met een hoge pixeldichtheid.

Voorbeelden

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);

Resultaat

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

Beide kandidaten hebben dezelfde resolutie. Het resultaat isoleert MIME-filtering, zonder te raden welke pixeldichtheid de browser zou kiezen.

Bronnen