mask-border-outset

The mask-border-outset CSS property specifies the distance by which an element's mask border is set out from its border box.

Syntax

/* <length> value */
mask-border-outset: 1rem;

/* <number> value */
mask-border-outset: 1.5;

/* vertical | horizontal */
mask-border-outset: 1 1.2;

/* top | horizontal | bottom */
mask-border-outset: 30px 2 45px;

/* top | right | bottom | left */
mask-border-outset: 7px 12px 14px 5px;

/* Global values */
mask-border-outset: inherit;
mask-border-outset: initial;
mask-border-outset: revert;
mask-border-outset: unset;

The mask-border-outset property may be specified as one, two, three, or four values. Each value is a <length> or <number>. Negative values are invalid.

  • When one value is specified, it applies the same outset to all four sides.
  • When two values are specified, the first outset applies to the top and bottom, the second to the left and right.
  • When three values are specified, the first outset applies to the top, the second to the left and right, the third to the bottom.
  • When four values are specified, the outsets apply to the top, right, bottom, and left in that order (clockwise).

Values

<length>

The size of the mask border outset as a dimension.

<number>

The size of the mask border outset as a multiple of the corresponding border-width.

Formal definition

Initial value 0
Applies to all elements; In SVG, it applies to container elements excluding the defs element and all graphics elements
Inherited no
Computed value as specified, but with relative lengths converted into absolute lengths
Animation type discrete

Formal syntax

[ <length> | <number> ]{1,4}

Examples

Basic usage

This property doesn't appear to be supported anywhere yet. When it eventually starts to be supported, it will serve to move the mask away from the inner edge of the element's border box — you can use it to make the mask start from part way across the border, rather than the inside of it.

mask-border-outset: 1rem;

Chromium-based browsers support an outdated version of this property — mask-box-image-outset — with a prefix:

-webkit-mask-box-image-outset: 1rem;

Note: The mask-border page features a working example (using the out-of-date prefixed border mask properties supported in Chromium), so you can get an idea of the effect.

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
mask-border-outset
1
79
No
No
15
3.1
1
18
No
14
3
1.0

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/mask-border-outset