mask-mode

The mask-mode CSS property indicates whether the mask reference defined by mask-image is treated as a luminance or alpha mask.

/* Keyword values */
mask-mode: alpha;
mask-mode: luminance;
mask-mode: match-source;
/* Multiple values */
mask-mode: alpha, match-source;
/* Global values */
mask-mode: inherit;
mask-mode: initial;
mask-mode: unset;

Syntax

One or more of the keyword values listed below, separated by commas.

Values

alpha

This keyword indicates that the transparency (alpha channel) values of the mask layer image should be used as the mask values.

luminance

This keyword indicates that the luminance values of the mask layer image should be used as the mask values.

match-source

If the mask-image property is of type <mask-source>, the luminance values of the mask layer image should be used as the mask values.

If it is of type <image>, the alpha values of the mask layer image should be used as the mask values.

Formal syntax

<masking-mode>#
where 
<masking-mode> = alpha | luminance | match-source

Example

CSS Content

#masked {
  width: 227px;
  height: 200px;
  background: blue linear-gradient(red, blue);
  mask-image: url(https://mdn.mozillademos.org/files/12668/MDN.svg);
  mask-mode: alpha; /* Can be changed in the live sample */
}

<div id="masked">
</div>
<select id="maskMode">
  <option value="alpha">alpha</option>
  <option value="luminance">luminance</option>
  <option value="match-source">match-source</option>
</select>

var maskMode = document.getElementById("maskMode");
maskMode.addEventListener("change", function (evt) {
  document.getElementById("masked").style.maskMode = evt.target.value;
});

Specifications

Browser compatibility