Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

image-set(): alternativas para una imagen

Ofrece imágenes candidatas con resolución y tipo opcional para que el navegador elija una fuente utilizable.

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

Sintaxis

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

image-set() describe alternativas de una sola imagen; no apila varias capas de fondo. Cada candidata puede indicar una resolución, como 1x o 2x, y una pista MIME mediante type(). El navegador elige según los formatos compatibles, las características de la pantalla y sus propios criterios. Por ello, una relación de píxeles concreta no garantiza incondicionalmente la selección de un archivo determinado.

type() permite descartar un formato no compatible antes de cargarlo. No convierte el archivo, no impone un decodificador ni garantiza que sus bytes coincidan con la etiqueta. Si necesitas una alternativa para navegadores sin esta sintaxis, coloca antes una declaración background-image normal. No se permite anidar funciones image-set().

El ejemplo usa dos imágenes de degradado generadas. Etiqueta deliberadamente la candidata roja con un MIME no compatible y la azul con image/png, ambas a 1x; esa etiqueta no convierte el degradado en un archivo PNG. El píxel azul medido confirma que se descartó la candidata incompatible. No hay descargas de red y la prueba no pretende medir la selección para pantallas de alta densidad.

Ejemplos

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

Resultado

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

Las dos candidatas tienen la misma resolución: el resultado aísla el filtrado MIME, sin adivinar qué densidad preferirá el navegador.

Fuentes