CSS Masking - mask-border-source Property

The CSS property mask-border-source sets the source image that is used for creating an element's mask border.

This source image can be divided into different regions using the mask-border-slice CSS property.

Possible values

The CSS property mask-border-source can have following values:

  • none: No mask border is applied.

  • <image>: Reference of the image to be used for mask border.

Applies to

All HTML elements. And in case of SVG, it applies to the container element excluding the <defs> element and all graphics elements

Syntax

/* Keyword value */
mask-border-source = none;

/* <image> values */
mask-border-source = url(<image-filename>);
mask-border-source = linear-gradient(to bottom, red, yellow);

Note: The chromium-based browsers support the old version of this property mask-box-image-source with a prefix, i.e., -webkit.

-webkit-mask-border-source = url(image.png);

CSS mask-border-source - Basic Example

The following example demonstrates the use of the CSS property mask-border-source, where an image is passed as the mask border using the url(), which is applied as the mask border for the element.

<html>
<head>
<style>
   .with-mask {
      -webkit-mask-box-image-source: url("images/logo.png");
      -webkit-mask-box-image-slice:   20 fill;
      -webkit-mask-box-image-width:   25px;            /* width */
      -webkit-mask-box-image-outset:   2px;               /* outset */
      -webkit-mask-box-image-repeat:   repeat;            /* repeat */
      
   
      mask-border-source: url("images/logo.png");
      mask-border-slice: 20 fill;       /* slice */
      mask-border-width: 25px;           /* width */
      mask-border-outset: 2px;            /* outset */
      mask-border-repeat: repeat;          /* repeat */
  }
</style>
</head>
<body>
   <h1>The mask-border-source Property</h1>

   <h3>With mask-border-source</h3>
   <div class="with-mask">
   <img src="images/scenery2.jpg" alt="mask border image" width="300" height="200">
   </div>

   <h3>Without mask-border-source</h3>
   <img src="images/scenery2.jpg" alt="mask border image" width="300" height="200">
</body>
</html>
Advertisements