Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

Proprietà CSS `mask-mode`

`mask-mode` sceglie per ogni livello se i valori di maschera provengono dall’alfa, dalla luminanza moltiplicata per alfa o dal tipo della sorgente.

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

Sintassi

<masking-mode>#

mask-mode sceglie per ogni livello se i valori di maschera provengono dall’alfa, dalla luminanza moltiplicata per alfa o dal tipo della sorgente.

L’esempio rasterizzato in Chromium usa nero opaco: alpha lo mantiene visibile a 255, luminance lo nasconde a 0 e match-source produce 255 per un gradiente CSS ma 0 per un URL verso <mask mask-type="luminance">.

Grammatica: <masking-mode>#.

match-source significa alfa per una normale sorgente <image>, ma con un URL a un SVG <mask> segue il suo mask-type; alpha o luminance espliciti prevalgono. Il nero completamente opaco è quindi una maschera piena in modalità alfa e nulla in modalità luminanza. Il valore iniziale è match-source; la lista si ripete o si tronca al numero di livelli mask-image e non influisce su mask-border-source.

Esempi

<!doctype html><meta charset="utf-8"><svg id="stage" xmlns="http://www.w3.org/2000/svg" width="150" height="20"><defs><mask id="lum" maskUnits="userSpaceOnUse" x="120" y="0" width="30" height="20" mask-type="luminance"><rect x="120" width="30" height="20" fill="black"/></mask></defs><rect id="alphaBox" width="30" height="20" fill="orange" style="mask-image:linear-gradient(black,black);mask-mode:alpha"/><rect id="luminanceBox" x="40" width="30" height="20" fill="orange" style="mask-image:linear-gradient(black,black);mask-mode:luminance"/><rect id="matchImage" x="80" width="30" height="20" fill="orange" style="mask-image:linear-gradient(black,black);mask-mode:match-source"/><rect id="matchMask" x="120" width="30" height="20" fill="orange" style="mask-image:url(#lum);mask-mode:match-source"/></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()=>{const context=await rasterize(stage),a=alpha(context,15,10),l=alpha(context,55,10),mi=alpha(context,95,10),mm=alpha(context,135,10),modes=[alphaBox,luminanceBox,matchImage,matchMask].map(node=>getComputedStyle(node).maskMode).join('/');if(a<250||l>5||mi<250||mm>5||modes!=='alpha/luminance/match-source/match-source')throw new Error('mask-mode interpretation mismatch');result.textContent='alpha='+a+'; luminance='+l+'; match-image='+mi+'; match-mask='+mm+'; modes='+modes})().catch(error=>result.textContent='ERROR:'+error.message);
</script>

Risultato

alpha=255; luminance=0; match-image=255; match-mask=0; modes=alpha/luminance/match-source/match-source

L’esempio è stato eseguito localmente in una sessione Chrome isolata e senza rete; il risultato proviene dall’API CSS del browser.

Fonti