CKTIS / CSS
Proprietà CSS `mask`
`mask` riunisce in una dichiarazione immagine, posizione, dimensione, ripetizione, aree geometriche, modalità di interpretazione e operatore di composizione di ogni livello.
Versione: CSS modules; captured CSSWG editor index includes draft and obsolete features requiring review
Sintassi
<mask-layer>#mask riunisce in una dichiarazione immagine, posizione, dimensione, ripetizione, aree geometriche, modalità di interpretazione e operatore di composizione di ogni livello.
L’esempio imposta prima longhand non iniziali e poi le sostituisce con una forma abbreviata a gradiente: il raster SVG ha alfa 255 a sinistra e 0 a destra, mentre i componenti omessi tornano a match-source, repeat, auto, border-box e add.
Grammatica: <mask-layer>#.
Le virgole creano i livelli; in un livello la dimensione può comparire solo dopo una barra successiva alla posizione, e una sola geometry box imposta sia origin sia clip. I componenti omessi assumono il valore iniziale per livello, le liste corte si ripetono fino al numero di immagini e i valori eccedenti vengono ignorati. La forma abbreviata azzera anche mask-border; la maschera cambia la pittura, non geometria o hit testing.
Esempi
<!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>Risultato
alpha=255/0; mode=match-source; repeat=repeat; size=auto; clip=border-box; origin=border-box; composite=add
L’esempio è stato eseguito localmente in una sessione Chrome isolata e senza rete; il risultato proviene dall’API CSS del browser.