CKTIS / CSS
CSS-eigenschap `mask`
`mask` schrijft afbeelding, positie, grootte, herhaling, geometriegebieden, interpretatiemodus en compositie-operator van elke maskerlaag in één declaratie.
Versie: CSS modules; captured CSSWG editor index includes draft and obsolete features requiring review
Syntax
<mask-layer>#mask schrijft afbeelding, positie, grootte, herhaling, geometriegebieden, interpretatiemodus en compositie-operator van elke maskerlaag in één declaratie.
Het voorbeeld stelt eerst niet-initiële deel-eigenschappen in en vervangt ze daarna door een verloop-shorthand: het SVG-raster heeft alfa 255 links en 0 rechts, terwijl weggelaten onderdelen teruggaan naar match-source, repeat, auto, border-box en add.
Grammatica: <mask-layer>#.
Komma’s maken lagen; binnen één laag mag grootte alleen na een schuine streep achter positie staan, en één geometry box stelt zowel origin als clip in. Weggelaten onderdelen krijgen per laag hun beginwaarde, korte lijsten worden herhaald tot het aantal beeldlagen en overtollige waarden genegeerd. De shorthand reset ook mask-border; maskering verandert schildering, niet vakgeometrie of treftesten.
Voorbeelden
<!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>Resultaat
alpha=255/0; mode=match-source; repeat=repeat; size=auto; clip=border-box; origin=border-box; composite=add
Het voorbeeld is lokaal uitgevoerd in een geïsoleerde Chrome-sessie zonder netwerk; het resultaat komt uit de CSS-API van de browser.