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
Copy Code
#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 */ }
HTML Content
HTML
Copy Code
<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>
JavaScript Content
JavaScript
Copy Code
var maskMode = document.getElementById("maskMode"); maskMode.addEventListener("change", function (evt) { document.getElementById("masked").style.maskMode = evt.target.value; });
Syntax
CSS
Copy Code
/* 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
Copy Code
<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 value | match-source |
---|---|
Applies to | all elements; In SVG, it applies to container elements excluding the <defs> element and all graphics elements |
Inherited | no |
Media | visual |
Computed value | as specified |
Animatable | no |
Canonical order | the 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