Proprietà mask-mode

La proprietà mask-mode imposta il modo in cui la maschera interagisce con lo sfondo dell'elemento. Determina se la maschera utilizzerà il canale alfa (trasparenza) o i valori di luminosità (luminance) dell'immagine-maschera.

Sintassi

selettore {
	mask-mode: alpha | luminance | match-source;
}

Valori

Valore	Descrizione
`alpha`	La maschera utilizza solo il canale alfa (trasparenza) dell'immagine.
`luminance`	La maschera utilizza i valori di luminosità dell'immagine (bianco = visibile, nero = trasparente).
`match-source`	Per le immagini utilizza il canale alfa, per SVG - luminance (valore predefinito).

Esempio . Modalità alpha

Applicazione di una maschera SVG in modalità alpha:

<img id="image" src="image.jpg">

#image {
	width: 500px;
	height: 281px;
	mask: url("heart.svg") center/150px no-repeat;
	mask-mode: alpha;
}

Esempio . Modalità luminance

Applicazione di una maschera SVG in modalità luminance:

<img id="image" src="image.jpg">

#image {
	width: 500px;
	height: 281px;
	mask: url("heart.svg") center/150px no-repeat;
	mask-mode: luminance;
}

Esempio . Maschera SVG con modalità match-source

Utilizzo del valore predefinito (match-source) per SVG:

<img id="image" src="image.jpg">
<svg width="0" height="0">
	<mask id="svg-mask">
		<path d="M150 15L183 111L285 111L204 171L237 267L150 216L63 267L96 171L15 111L117 111Z" fill="white"/>
	</mask>
</svg>

#image {
	width: 500px;
	height: 281px;
	mask: url(#svg-mask);
	mask-mode: match-source;
}

Esempio . Composizione con diverse modalità

Combinazione di maschere con diverse modalità di fusione:

<img id="image" src="image.jpg">

#image {
	width: 500px;
	height: 281px;
	mask: 
		url("heart.svg") 100px 50px / 150px no-repeat alpha,
		url("arrow.svg") 200px 30px / 150px no-repeat luminance;
	mask-composite: add;
}

Vedi anche

proprietà mask-image,
imposta l'immagine per la maschera
proprietà mask-composite,
definisce l'interazione di più maschere
proprietà mask,
scorciatoia per tutte le proprietà di mascheratura