CSS - mask-mode

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

Example

 

CSS Content

CSS
#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 */
}

Syntax  

CSS
/* 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;

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

CSS
<a href="css/mask-mode#masking-mode"><masking-mode></a><a href="css/value_definition_syntax#hash_mark_(.23)" title="Hash mark">#</a><p>where <br><code><masking-mode> = alpha <a href="css/value_definition_syntax#single_bar" title="Single bar">|</a> luminance <a href="css/value_definition_syntax#single_bar" title="Single bar">|</a> match-source</code></p>

Description  

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

Initial valuematch-source
Applies toall elements; In SVG, it applies to container elements excluding the <defs> element and all graphics elements
Inheritedno
Mediavisual
Computed valueas specified
Animatableno
Canonical orderthe unique non-ambiguous order defined by the formal grammar

Browser Compatibility  

Feature Chrome Firefox (Gecko) Internet Explorer Edge Opera Safari (WebKit)
Basic support No support No support[1] No support ? No support No support
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support No support No support[1] No support No support No support

[1] This feature is not implemented yet. See bug 1251161.

Specifications  

Specification Status Comment
CSS Masking Level 1
The definition of 'mask-mode' in that specification.
Candidate Recommendation Initial definition

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/css/mask-mode

CSS CSS Masks CSS Property Non-standard Reference