mask-repeat

在此页

句法
形式定义
形式句法
范例
规范
浏览器兼容性
相关话题

mask-repeat CSS property sets how mask images are repeated. A mask image can be repeated along the horizontal axis, the vertical axis, both axes, or not repeated at all.

/* One-value syntax */
mask-repeat: repeat-x;
mask-repeat: repeat-y;
mask-repeat: repeat;
mask-repeat: space;
mask-repeat: round;
mask-repeat: no-repeat;
/* Two-value syntax: horizontal | vertical */
mask-repeat: repeat space;
mask-repeat: repeat repeat;
mask-repeat: round space;
mask-repeat: no-repeat round;
/* Multiple values */
mask-repeat: space round, no-repeat;
mask-repeat: round repeat, space, repeat-x;
/* Global values */
mask-repeat: inherit;
mask-repeat: initial;
mask-repeat: unset;

By default, the repeated images are clipped to the size of the element, but they can be scaled to fit (using round ) or evenly distributed from end to end (using space ).

句法

One or more <repeat-style> values, separated by commas.

值

<repeat-style>

形式定义

初始值	`no-repeat`
适用于	all elements; In SVG, it applies to container elements excluding the `defs` element and all graphics elements
继承	no
计算值	Consists of two keywords, one per dimension
动画类型	discrete

形式句法

<repeat-style>#where 
<repeat-style> = repeat-x | repeat-y | [ repeat | space | round | no-repeat ]{1,2}

范例

Setting repeat for a single mask

CSS

#masked {
  width: 250px;
  height: 250px;
  background: blue linear-gradient(red, blue);
  mask-image: url(https://mdn.mozillademos.org/files/12676/star.svg);
  mask-repeat: repeat; /* Can be changed in the live sample */
  margin-bottom: 10px;
}

HTML 内容

<div id="masked">
</div>
<select id="repetition">
  <option value="repeat-x">repeat-x</option>
  <option value="repeat-y">repeat-y</option>
  <option value="repeat" selected>repeat</option>
  <option value="space">space</option>
  <option value="round">round</option>
  <option value="no-repeat">no-repeat</option>
</select>

JavaScript Content

var repetition = document.getElementById("repetition");
repetition.addEventListener("change", function (evt) {
  document.getElementById("masked").style.maskRepeat = evt.target.value;
});

结果

Multiple mask image support

You can specify a different <repeat-style> for each mask image, separated by commas:

.examplethree {
  mask-image: url('mask1.png'), url('mask2.png');
  mask-repeat: repeat-x, repeat-y;
}

Each image is matched with the corresponding repeat style, from first specified to last.

规范

规范	状态	注释
CSS Masking Module Level 1 The definition of 'mask-repeat' in that specification.	候选推荐	初始定义

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`mask-repeat`	Chrome 完整支持 1 Prefixed 完整支持 Prefixed Prefixed Implemented with the vendor prefix: -webkit-	Edge 完整支持 18	Firefox 完整支持 53 完整支持 53 不支持 20 — 53 Disabled Disabled ). To change preferences in Firefox, visit	IE 不支持 No	Opera 完整支持 15 Prefixed 完整支持 Prefixed Prefixed Implemented with the vendor prefix: -webkit-	Safari 完整支持 3.2 Prefixed 完整支持 Prefixed Prefixed Implemented with the vendor prefix: -webkit-	WebView Android 完整支持 2 Prefixed 完整支持 Prefixed Prefixed Implemented with the vendor prefix: -webkit-	Chrome Android 完整支持 18 Prefixed 完整支持 Prefixed Prefixed Implemented with the vendor prefix: -webkit-	Firefox Android 完整支持 53 完整支持 53 不支持 20 — 53 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 完整支持 14 Prefixed 完整支持 Prefixed Prefixed Implemented with the vendor prefix: -webkit-	Safari iOS 完整支持 3.2 Prefixed 完整支持 Prefixed Prefixed Implemented with the vendor prefix: -webkit-	Samsung Internet Android 完整支持 1.0 Prefixed 完整支持 Prefixed Prefixed Implemented with the vendor prefix: -webkit-

图例

完整支持
不支持
用户必须明确启用此特征。
要求使用供应商前缀或不同名称。

元数据

最后修改： Jul 20, 2020

CSS
CSS 参考
CSS Masking
特性
1. clip
2. clip-path
3. mask
4. mask-border
5. mask-border-mode
6. mask-border-outset
7. mask-border-repeat
8. mask-border-slice
9. mask-border-source
10. mask-border-width
11. mask-clip
12. mask-composite
13. mask-image
14. mask-mode
15. mask-origin
16. mask-position
17. mask-repeat
18. mask-size
19. mask-type

Single value	Two-value equivalent
`repeat-x`	`repeat no-repeat`
`repeat-y`	`no-repeat repeat`
`repeat`	`repeat repeat`
`space`	`space space`
`round`	`round round`
`no-repeat`	`no-repeat no-repeat`

`repeat`	The image is repeated as much as needed to cover the whole mask painting area. The last image will be clipped if it doesn't fit.
`space`	The image is repeated as much as possible without clipping. The first and last images are pinned to either side of the element, and whitespace is distributed evenly between the images. The `mask-position` property is ignored unless only one image can be displayed without clipping. The only case where clipping happens using `space` is when there isn't enough room to display one image.
`round`	As the allowed space increases in size, the repeated images will stretch (leaving no gaps) until there is room for another one to be added. When the next image is added, all of the current ones compress to allow room. Example: An image with an original width of 260px, repeated three times, might stretch until each repetition is 300px wide, and then another image will be added. They will then compress to 225px.
`no-repeat`	The image is not repeated (and hence the mask painting area will not necessarily be entirely covered). The position of the non-repeated mask image is defined by the `mask-position` CSS property.

在此页

句法

值