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

`-webkit-mask-box-image` CSS 属性

· 52CE 我爱测

**`-webkit-mask-box-image`** CSS 属性是一个非标准的带前缀简写,用于为元素的边框盒设置遮罩图像。

-webkit-mask-box-image CSS 属性是一个非标准的带前缀简写,用于为元素的边框盒设置遮罩图像。

[!NOTE] 此属性不属于标准,也未纳入任何标准轨道。请考虑改用 mask-border 属性。

构成属性

该属性是以下 CSS 属性的简写:

  • mask-border-source
  • mask-border-outset
  • mask-border-repeat

其取值包括用作遮罩边框的 <image>,以及可选的四个边框外扩值和最多两种边框重复样式。

语法

/* 默认值 */
-webkit-mask-box-image: none;

/* 图像 */
-webkit-mask-box-image: url("image.png");

/* 图像与边缘偏移 */
-webkit-mask-box-image: url("image.png") 10 20 20 10;
-webkit-mask-box-image: url("image.png") 10px 20px 20px 10px;

/* 图像与重复方式 */
-webkit-mask-box-image: url("image.png") space repeat;

/* 图像、边缘偏移与重复方式 */
-webkit-mask-box-image: url("image.png") 10px 20px 20px 10px space repeat;

/* 全局值 */
-webkit-mask-box-image: inherit;
-webkit-mask-box-image: initial;
-webkit-mask-box-image: revert;
-webkit-mask-box-image: revert-layer;
-webkit-mask-box-image: unset;

值

  • <image>
    • : 作为遮罩图像使用的图像资源的位置、gradient 或其他 <image> 取值。
  • none
    • : 表示边框盒不使用遮罩图像。
  • <length>
    • : 遮罩图像偏移的大小。可用单位见 <length>。
  • <percentage>
    • : 遮罩图像的偏移为百分比,相对于边框盒对应方向的尺寸(宽度或高度)。
  • <number>
    • : 遮罩图像偏移的像素大小。
  • repeat
    • : 遮罩图像重复足够多次以铺满边框盒。若遮罩图像无法被边框盒尺寸整除分块,末端可能出现不完整的图像。
  • stretch
    • : 拉伸遮罩图像使其恰好填满边框盒。
  • round
    • : 将遮罩图像略作拉伸并重复,使边框盒末端不会出现不完整的遮罩图像。
  • space
    • : 在不拉伸的前提下尽可能多次重复遮罩图像。边框盒末端不会出现不完整的遮罩图像。

外扩值(或称边缘偏移)按上、右、下、左的顺序,表示从图像相应边缘起算的距离。可取值为 <length>、<number> 或 <percentage>,其中数字会按像素长度解释。

若写出边框重复样式,则按 <repeat-x> <repeat-y> 的顺序解释;若只声明一个值,则两个轴使用相同取值。其行为与 background-repeat 类似,但不支持 cover 和 contain。

形式定义

形式语法

示例

设置图像

.example-one {
  -webkit-mask-box-image: url("mask.png");
}

偏移并填充图像

.example-two {
  -webkit-mask-box-image: url("logo.png") 100px 100px 0px 0px round round;
}

规范

不属于任何标准。

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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