The mask-type attribute indicates which mask mode, alpha or luminance, to use for the contents of the mask element when masking.
You can use this attribute with the following SVG elements:
- mask
[!NOTE] This presentation attribute has a CSS property counterpart: mask-type. When both are specified, the CSS property takes priority.
mask
For mask, the mask-type defines whether the content of the mask element is treated as a luminance mask or an alpha mask.
<table class="properties"> <tbody> <tr> <th scope="row">Value</th> <td><code>alpha</code> | <code>luminance</code></td> </tr> <tr> <th scope="row">Default value</th> <td><code>luminance</code></td> </tr> <tr> <th scope="row">Animatable</th> <td>Discrete</td> </tr> </tbody> </table>
alpha- : This value indicates that the mask element's alpha values should be used; the pixels of the masked object match the opaqueness of the mask areas, without regard to the luminance of the colors of the mask.
luminance- : This value indicates that the mask element's luminance values should be used; the opaqueness of the masked object depends on the opacity and lightness of the mask. The opacity of a
luminancemask is determined by theR,G,B, andAchannels of the mask, using the equation((0.2125 * R) + (0.7154 * G) + (0.0721 * B)) * A.
- : This value indicates that the mask element's luminance values should be used; the opaqueness of the masked object depends on the opacity and lightness of the mask. The opacity of a
Example
html,
body,
svg {
height: 100%;
}
<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
<mask id="myMask1" mask-type="alpha">
<rect
fill="rgb(10% 10% 10% / 0.4)"
x="0"
y="0"
width="100%"
height="100%" />
<circle fill="rgb(90% 90% 90% / 0.6)" cx="50" cy="50" r="35" />
</mask>
<mask id="myMask2" mask-type="luminance">
<rect
fill="rgb(10% 10% 10% / 0.4)"
x="0"
y="0"
width="100%"
height="100%" />
<circle fill="rgb(90% 90% 90% / 0.6)" cx="50" cy="50" r="35" />
</mask>
<rect x="0" y="0" width="45" height="45" mask="url(#myMask1)" fill="red" />
<rect x="55" y="0" width="45" height="45" mask="url(#myMask2)" fill="red" />
</svg>
Example
Specifications
Browser compatibility
See also
- CSS mask-type property
- CSS mask-mode property
- Introduction to CSS masking
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
