CSS mask-image Property

❮ Previous Complete CSS Reference Next ❯

Example

Create a mask layer for an image:

.mask1 {
-webkit-mask-image: url(w3logo.png);
mask-image: url(w3logo.png);
mask-size: 70%;
mask-repeat: no-repeat;
}

Try it Yourself »

More "Try it Yourself" examples below.

Definition and Usage

The mask-image property specifies an image to be used as a mask layer for an element.

Tip: Linear and radial gradients in CSS can also be used as the mask image.

Default value:	none
Inherited:	no
Animatable:	no. Read about animatable
Version:	CSS Masking Module Level 1
JavaScript syntax:	object.style.maskImage="url(star.svg)"

Browser Support

The numbers in the table specify the first browser version that fully supports the property.

Numbers followed by -webkit- specify the first version that worked with a prefix.

Property
mask-image	120	120	53	15.4	15 -webkit-

CSS Syntax

mask-image: none|image|url()|initial|inherit;

Property Values

Value	Description
none	This is default
image	An image to use as the mask layer
url()	A URL reference to an image or an SVG <mask> element
initial	Sets this property to its default value. Read about initial
inherit	Inherits this property from its parent element. Read about inherit

More Examples

Example

Create different mask layers for an image with linear and radial gradients:

.mask1 {
-webkit-mask-image: linear-gradient(black, transparent);
mask-image: linear-gradient(black, transparent);
}

.mask2 {
-webkit-mask-image: radial-gradient(circle, black 50%, rgba(0, 0, 0, 0.5) 50%);
mask-image: radial-gradient(circle, black 50%, rgba(0, 0, 0, 0.5) 50%);
}

.mask3 {
-webkit-mask-image: radial-gradient(black 50%, rgba(0, 0, 0, 0.5) 50%);
mask-image: radial-gradient(black 50%, rgba(0, 0, 0, 0.5));
}

Try it Yourself »