Propiedad mask-mode

La propiedad mask-mode establece la forma en que la máscara interactúa con el fondo del elemento. Define si la máscara utilizará el canal alfa (transparencia) o los valores de luminancia (luminance) de la imagen de máscara.

Sintaxis

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

Valores

Valor	Descripción
`alpha`	La máscara utiliza solo el canal alfa (transparencia) de la imagen.
`luminance`	La máscara utiliza los valores de luminancia de la imagen (blanco = visible, negro = transparente).
`match-source`	Para imágenes utiliza el canal alfa, para SVG - luminance (valor por defecto).

Ejemplo . Modo alpha

Aplicación de máscara SVG en modo alpha:

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

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

Ejemplo . Modo luminance

Aplicación de máscara SVG en modo luminance:

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

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

Ejemplo . Máscara SVG con modo match-source

Uso del valor por defecto (match-source) para 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;
}

Ejemplo . Composición con diferentes modos

Combinación de máscaras con diferentes modos de fusión:

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

Véase también

propiedad mask-image,
establece la imagen para la máscara
propiedad mask-composite,
define la interacción de múltiples máscaras
propiedad mask,
abreviatura para todas las propiedades de enmascaramiento