Proprietà mask-image

La proprietà mask-image consente di impostare un'immagine che verrà utilizzata come maschera per l'elemento. La maschera determina quali parti dell'elemento saranno visibili e quali saranno nascoste. Come maschera si possono utilizzare immagini SVG, PNG o gradienti.

Sintassi

selettore {
	mask-image: none | <image> | <url>;
}

Valori

Valore	Descrizione
`none`	Disabilita la mascheratura (valore predefinito).
`url()`	Percorso dell'immagine maschera (SVG, PNG).
`linear-gradient()`	Gradiente lineare come maschera.
`radial-gradient()`	Gradiente radiale come maschera.

Esempio . Utilizzo di SVG come maschera

Applichiamo un'immagine SVG a forma di cuore come maschera su un'immagine:

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

#image {
	width: 500px;
	height: 281px;
	mask-image: url("heart.svg");
	mask-position: center;
	mask-size: 300px;
	mask-repeat: no-repeat;
}

Esempio . Utilizzo di un gradiente come maschera

Applichiamo un gradiente lineare come maschera per un elemento:

<div id="elem"></div>

#elem {
	width: 500px;
	height: 300px;
	background: linear-gradient(45deg, red, blue);
	mask-image: linear-gradient(to right, transparent, black);
}

Esempio . Utilizzo di un elemento SVG come maschera

Creiamo una maschera utilizzando un elemento SVG e applichiamola a un'immagine:

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

#image {
	width: 500px;
	height: 281px;
	mask-image: url(#mask);
	mask-position: center;
	mask-size: contain;
	mask-repeat: no-repeat;
}

Vedi anche

proprietà mask-position,
determina la posizione della maschera rispetto all'elemento
proprietà mask-size,
determina le dimensioni della maschera
proprietà mask-repeat,
determina la ripetizione della maschera
proprietà mask-mode,
determina come la maschera interagisce con lo sfondo
proprietà mask,
scorciatoia per tutte le proprietà di mascheratura