CKTIS / CSS
image-set(): alternativas para uma imagem
Disponibilize imagens candidatas com resolução e tipo opcional para o navegador selecionar uma fonte utilizável.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
background-image: image-set(url("small.png") 1x, url("large.png") 2x);image-set() descreve alternativas de uma única imagem; não sobrepõe várias camadas de fundo. Cada candidata pode indicar uma resolução, como 1x ou 2x, e uma indicação MIME em type(). O navegador escolhe segundo os formatos suportados, as características do ecrã e os seus próprios critérios. Uma dada relação entre píxeis do dispositivo e píxeis CSS não garante, portanto, a seleção de um ficheiro específico.
type() permite excluir um formato não suportado antes de o carregar. Não converte o ficheiro, não impõe um descodificador nem garante que os bytes correspondam à indicação. Quando precisar de uma alternativa para navegadores sem esta sintaxe, coloque antes uma declaração background-image normal. Não é permitido aninhar funções image-set().
O exemplo utiliza duas imagens de gradiente geradas. Identifica deliberadamente a candidata vermelha com um MIME não suportado e a azul como image/png, ambas a 1x; essa indicação não transforma o gradiente num ficheiro PNG. O píxel azul medido comprova a exclusão da candidata incompatível. Não há transferências de rede e o teste não mede a escolha de imagens para ecrãs de maior densidade.
Exemplos
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);Resultado
supported=true; filtered-pixel=0,0,255; nested=false
As candidatas têm a mesma resolução. O resultado isola a filtragem MIME, sem adivinhar a densidade que o navegador irá preferir.