CSSmask Property
Example
Create a mask layer for an image:
mask: url(w3logo.png) no-repeat 50% 50%;
}
More "Try it Yourself" examples below.
Definition and Usage
Themask property is used to hide an element (partially or fully) by masking or clipping the image at specific points:
Themask property is a shorthand property for the following:
| Default value: | none match-source repeat 0% 0% border-box border-box auto add |
|---|---|
| Inherited: | no |
| Animatable: | no.Read aboutanimatable |
| Version: | CSS Masking Module Level 1 |
| JavaScript syntax: | object.style.mask="url(star.svg)" |
Browser Support
The numbers in the table specify the first browser version that fully supports the property.
| Property | |||||
|---|---|---|---|---|---|
| mask | 120 | 120 | 53 | 15.4 | 106 |
CSS Syntax
Property Values
| Value | Description |
|---|---|
| mask-image | Specifies an image to be used as a mask layer for an element. Default value is none |
| mask-mode | Specifies whether the mask layer image should be treated as a luminance mask or as an alpha mask. Default value is match-source |
| mask-repeat | Sets if/how a mask image will be repeated. Default value is repeat |
| mask-position | Sets the starting position of a mask image (relative to the mask position area). Default value is 0% 0% |
| mask-clip | Specifies which area is affected by a mask image. Default value is border-box |
| mask-origin | Specifies the origin position (the mask position area) of a mask layer image. Default value is border- box |
| mask-size | Specifies the size of the mask layer image. Default value is auto |
| mask-composite | Specifies a compositing operation used on the current mask layer with the mask layers below it. Default value is add |
| initial | Sets this property to its default value.Read aboutinitial |
| inherit | Inherits this property from its parent element.Read aboutinherit |
More Examples
Example
Create different mask layers for an image with linear and radial gradients:
mask: linear-gradient(black, transparent);
}
.mask2 {
mask: radial-gradient(circle, black 50%, rgba(0, 0, 0, 0.5) 50%);
}
.mask3 {
mask: radial-gradient(ellipse, black 50%, rgba(0, 0, 0, 0.5) 50%);
}
Example
Use the SVG <mask> element to create a mask layer for an image:
<mask id="svgmask1">
<polygon fill="#ffffff" points="100,10 40,198 190,78 10,78 160,198"></polygon>
</mask>
<image xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="img_5terre.jpg" mask="url(#svgmask1)"></image>
</svg>
Example
Use the SVG <mask> element to create a mask layer for an image:
<mask id="svgmask1">
<circle fill="#ffffff" cx="75" cy="75" r="75"></circle>
<circle fill="#ffffff" cx="80" cy="260" r="75"></circle>
<circle fill="#ffffff" cx="270" cy="160" r="75"></circle>
</mask>
<image xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="img_5terre.jpg" mask="url(#svgmask1)"></image>
</svg>
Related Pages
CSS reference:mask-clip property
CSS reference:mask-composite property
CSS reference:mask-image property
CSS reference:mask-mode property
CSS reference:mask-origin property
CSS reference:mask-position property
CSS reference:mask-repeat property
CSS reference:mask-size property
CSS tutorial:CSS Masking
