Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

Właściwość CSS `mask`

`mask` zapisuje w jednej deklaracji warstwy obrazu maski, ich pozycję, rozmiar, powtarzanie, obszary, sposób interpretacji i operator składania.

Wersja: CSS modules; captured CSSWG editor index includes draft and obsolete features requiring review

Składnia

<mask-layer>#

mask zapisuje w jednej deklaracji warstwy obrazu maski, ich pozycję, rozmiar, powtarzanie, obszary, sposób interpretacji i operator składania.

Przykład najpierw ustawia nietypowe wartości składowe, a potem zastępuje je skrótem z gradientem: raster SVG ma alfę 255 po lewej i 0 po prawej, natomiast pominięte składowe wracają do match-source, repeat, auto, border-box i add.

Składnia: <mask-layer>#.

Przecinki tworzą warstwy; w każdej pozycji rozmiar może wystąpić tylko po ukośniku za pozycją, a jedno pole geometrii ustawia jednocześnie origin i clip. Pominięte składniki przyjmują wartości początkowe dla każdej warstwy, krótsze listy są powtarzane do liczby obrazów, nadmiarowe wartości ignorowane. Skrót zeruje także mask-border; maskowanie zmienia malowanie, nie geometrię pudełka ani trafianie.

Przykłady

<!doctype html><meta charset="utf-8"><svg id="stage" xmlns="http://www.w3.org/2000/svg" width="40" height="20"><rect id="box" width="40" height="20" fill="red"/></svg><pre id="result"></pre><script>

const rasterize=svg=>new Promise((resolve,reject)=>{const image=new Image();image.onload=()=>{const canvas=document.createElement('canvas');canvas.width=Number(svg.getAttribute('width'));canvas.height=Number(svg.getAttribute('height'));const context=canvas.getContext('2d');context.drawImage(image,0,0);resolve(context)};image.onerror=()=>reject(new Error('SVG rasterization failed'));image.src='data:image/svg+xml;charset=utf-8,'+encodeURIComponent(new XMLSerializer().serializeToString(svg))});
const alpha=(context,x,y)=>context.getImageData(x,y,1,1).data[3];
(async()=>{box.style.cssText='mask-mode:luminance;mask-repeat:no-repeat;mask-position:10px 0;mask-size:10px 20px;mask-clip:fill-box;mask-origin:fill-box;mask-composite:exclude';box.style.mask='linear-gradient(to right,black 0 50%,transparent 50%)';const style=getComputedStyle(box),context=await rasterize(stage),left=alpha(context,5,10),right=alpha(context,35,10);if(left<250||right>5||style.maskMode!=='match-source'||style.maskRepeat!=='repeat'||style.maskSize!=='auto'||style.maskClip!=='border-box'||style.maskOrigin!=='border-box'||style.maskComposite!=='add')throw new Error('mask reset/paint mismatch');result.textContent='alpha='+left+'/'+right+'; mode='+style.maskMode+'; repeat='+style.maskRepeat+'; size='+style.maskSize+'; clip='+style.maskClip+'; origin='+style.maskOrigin+'; composite='+style.maskComposite})().catch(error=>result.textContent='ERROR:'+error.message);
</script>

Wynik

alpha=255/0; mode=match-source; repeat=repeat; size=auto; clip=border-box; origin=border-box; composite=add

Przykład uruchomiono lokalnie w izolowanej, bezsieciowej sesji Chrome; wynik pochodzi z API CSS przeglądarki.

Źródła