Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

image-set(): alternatywne źródła jednego obrazu

Podaj warianty obrazu z rozdzielczością i opcjonalnym typem, aby przeglądarka wybrała obsługiwane źródło.

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

Składnia

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

image-set() opisuje alternatywy jednego obrazu, a nie kilka nakładanych warstw tła. Kandydat może mieć rozdzielczość, na przykład 1x lub 2x, oraz wskazówkę typu MIME w type(). Przeglądarka wybiera źródło na podstawie obsługiwanych formatów, parametrów ekranu i własnych zasad. Sam współczynnik gęstości pikseli nie daje więc bezwarunkowej gwarancji wyboru konkretnego pliku.

Wartość type() pozwala odrzucić nieobsługiwany format przed pobraniem. Nie konwertuje pliku, nie wymusza dekodera i nie gwarantuje zgodności bajtów z etykietą. Jeżeli potrzebujesz obsługi starszych przeglądarek, przed image-set() ustaw zwykłą deklarację background-image. Zagnieżdżanie image-set() w image-set() jest niedozwolone.

Przykład używa dwóch obrazów generowanych gradientem. Czerwony celowo oznacza nieobsługiwanym typem MIME, a niebieski typem image/png; oba mają 1x. Sama etykieta nie zmienia gradientu w plik PNG. Odczyt niebieskiego piksela potwierdza odrzucenie nieobsługiwanego kandydata. Test nie pobiera niczego z sieci i nie mierzy wyboru obrazu dla ekranu o większej gęstości.

Przykłady

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

Wynik

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

Oba warianty mają tę samą rozdzielczość. Wynik sprawdza filtrowanie MIME, zamiast zgadywać preferowaną przez przeglądarkę gęstość.

Źródła