-webkit-mask-box-image

非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。

非標準的字首屬性 -webkit-mask-box-image 是一個簡寫屬性,用於為元素的邊框盒設定遮罩影像。

注意: 此屬性不是標準屬性,也不在任何標準軌道上。請考慮改用 mask-border 屬性。

構成屬性

此屬性是以下 CSS 屬性的簡寫:

其值包括用作遮罩邊框的 <image>,以及可選的四個邊框外擴值和最多兩個邊框重複樣式。

語法

css
/* default */
-webkit-mask-box-image: none;

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

/* image edge-offset */
-webkit-mask-box-image: url("image.png") 10 20 20 10;
-webkit-mask-box-image: url("image.png") 10px 20px 20px 10px;

/* image repeat-style */
-webkit-mask-box-image: url("image.png") space repeat;

/* image edge-offset repeat-style */
-webkit-mask-box-image: url("image.png") 10px 20px 20px 10px space repeat;

/* Global values */
-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 類似,但不支援 covercontain 值。

正式定義

正式語法

-webkit-mask-box-image = 
<mask-image-source> [ <mask-image-offset>{4} <mask-border-repeat>{1,2} ]

示例

設定影像

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

偏移並填充影像

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

規範

不屬於任何標準。

瀏覽器相容性

另見