CKTIS / CSS
image-set() : plusieurs sources pour une image
Proposez des images avec leur résolution et, éventuellement, leur type pour laisser le navigateur choisir une source utilisable.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
background-image: image-set(url("small.png") 1x, url("large.png") 2x);image-set() décrit les variantes d’une seule image ; il ne superpose pas plusieurs couches d’arrière-plan. Chaque candidate peut préciser une résolution, comme 1x ou 2x, ainsi qu’une indication MIME avec type(). Le navigateur choisit selon les formats disponibles, les caractéristiques de l’affichage et ses propres règles. Un rapport de pixels donné ne garantit donc pas systématiquement la sélection d’un fichier précis.
La valeur type() permet d’écarter un format non pris en charge avant son chargement. Elle ne convertit pas le fichier, n’impose pas de décodeur et ne garantit pas que les octets correspondent à l’étiquette. Pour les navigateurs sans cette syntaxe, placez auparavant une déclaration background-image classique. Imbriquer image-set() dans image-set() est interdit.
L’exemple utilise deux images de dégradés générées. Il attribue volontairement un type MIME non pris en charge à la candidate rouge et image/png à la bleue, toutes deux à 1x ; cette étiquette ne transforme pas le dégradé en fichier PNG. Le pixel bleu mesuré confirme le filtrage de la candidate incompatible. Aucun téléchargement réseau n’intervient et le test ne mesure pas la sélection d’une image pour une forte densité de pixels.
Exemples
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);Résultat
supported=true; filtered-pixel=0,0,255; nested=false
Les deux candidates ont la même résolution : le résultat isole le filtrage MIME, sans supposer la densité que le navigateur préférerait.