Propriété mask-mode

La propriété mask-mode définit le mode d'interaction du masque avec l'arrière-plan de l'élément. Elle détermine si le masque utilisera le canal alpha (transparence) ou les valeurs de luminance de l'image du masque.

Syntaxe

sélecteur {
	mask-mode: alpha | luminance | match-source;
}

Valeurs

Valeur	Description
`alpha`	Le masque utilise uniquement le canal alpha (transparence) de l'image.
`luminance`	Le masque utilise les valeurs de luminance de l'image (blanc = visible, noir = transparent).
`match-source`	Pour les images utilise le canal alpha, pour le SVG - luminance (valeur par défaut).

Exemple . Mode alpha

Application d'un masque SVG en mode alpha :

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

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

Exemple . Mode luminance

Application d'un masque SVG en mode luminance :

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

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

Exemple . Masque SVG avec mode match-source

Utilisation de la valeur par défaut (match-source) pour le 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;
}

Exemple . Composition avec différents modes

Combinaison de masques avec différents modes de fusion :

<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;
}

Voir aussi

propriété mask-image,
définit l'image du masque
propriété mask-composite,
définit l'interaction de plusieurs masques
propriété mask,
raccourci pour toutes les propriétés de masquage