CKTIS / CSS
CSS-Eigenschaft `mask`
`mask` schreibt Bild, Position, Größe, Wiederholung, Geometriebereiche, Interpretationsmodus und Kompositionsoperator jeder Maskenebene in eine Deklaration.
Version: CSS modules; captured CSSWG editor index includes draft and obsolete features requiring review
Syntax
<mask-layer>#mask schreibt Bild, Position, Größe, Wiederholung, Geometriebereiche, Interpretationsmodus und Kompositionsoperator jeder Maskenebene in eine Deklaration.
Das Beispiel setzt zuerst nicht initiale Langformen und ersetzt sie dann durch eine Verlaufskurzform: Das SVG-Raster hat links Alpha 255 und rechts 0, während ausgelassene Komponenten auf match-source, repeat, auto, border-box und add zurückgesetzt werden.
Grammatik: <mask-layer>#.
Kommas erzeugen Ebenen; innerhalb einer Ebene darf eine Größe nur nach einem Schrägstrich hinter der Position stehen, und ein Geometriekasten setzt origin und clip zugleich. Ausgelassene Komponenten nehmen je Ebene ihren Anfangswert an, kürzere Listen werden bis zur Zahl der Bildebenen wiederholt und überzählige Werte ignoriert. Die Kurzform setzt auch mask-border zurück; Maskierung ändert die Malerei, nicht Kastengeometrie oder Treffertest.
Beispiele
<!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>Ergebnis
alpha=255/0; mode=match-source; repeat=repeat; size=auto; clip=border-box; origin=border-box; composite=add
Das Beispiel lief lokal in einer isolierten Chrome-Sitzung ohne Netzwerk; das Ergebnis stammt aus der CSS-API des Browsers.