大网数据广告活动
Web 标准与前端开发

mask-type

· 52CE 我爱测

The **`mask-type`** attribute indicates which mask mode, _alpha_ or _luminance_, to use for the contents of the mask element when masking.

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 luminance mask is determined by the R, G, B, and A channels of the mask, using the equation ((0.2125 * R) + (0.7154 * G) + (0.0721 * B)) * 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

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。