CKTIS / CSS
image-set(): alternative per una sola immagine
Offri immagini candidate con risoluzione e tipo facoltativo, così che il browser scelga una sorgente utilizzabile.
Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintassi
background-image: image-set(url("small.png") 1x, url("large.png") 2x);image-set() descrive alternative per una sola immagine; non sovrappone diversi livelli di sfondo. Ogni candidata può indicare una risoluzione, come 1x o 2x, e un suggerimento MIME tramite type(). Il browser sceglie in base ai formati supportati, alle caratteristiche dello schermo e alle proprie regole. Un particolare rapporto di pixel non garantisce quindi incondizionatamente la scelta di un certo file.
type() consente di scartare un formato non supportato prima del caricamento. Non converte il file, non impone un decoder e non garantisce che i byte corrispondano all’etichetta. Se serve un ripiego per browser privi di questa sintassi, inserisci prima una normale dichiarazione background-image. Non è consentito annidare funzioni image-set().
L’esempio usa due immagini a gradiente generate. Etichetta deliberatamente la candidata rossa con un MIME non supportato e quella blu con image/png, entrambe a 1x; l’etichetta non trasforma il gradiente in un file PNG. Il pixel blu campionato dimostra che la candidata incompatibile è stata esclusa. Non avvengono download di rete e il test non misura la scelta di immagini per schermi ad alta densità.
Esempi
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('&','&').replaceAll('"','"')+'"></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);Risultato
supported=true; filtered-pixel=0,0,255; nested=false
Le candidate hanno la stessa risoluzione: il risultato isola il filtro MIME, senza indovinare la densità preferita dal browser.