Quick Reference
The mask-image property specifies an image, CSS gradient, or SVG mask to be used as a mask layer for an element.
Using an Image
div {
mask-image: url("my_mask.png");
}
Using a Gradient
div {
mask-image: linear-gradient(black, transparent);
}
Using an SVG Mask
<svg width="600" height="600">
<mask id="my_mask">
<circle fill="#ffffff" cx="90" cy="90" r="90"></circle>
<circle fill="#ffffff" cx="280" cy="180" r="90"></circle>
</mask>
<image xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="my_mask_image.jpg" mask="url(#my_mask)"></image>
</svg>
Default
Default value | none |
Inherited values | no |
Can it be animated? | no |
These are the allowed values.
Value | Description |
---|---|
none | Default |
image | An image to use as the mask layer |
url | A url reference to an image or an SVG element |
initial | Sets this property to its default value |
inherit | Inherits this property from its parent element |
Using JavaScript
The HTML element can also be styled using JavaScript and the element’s id.
document.getElementById('my_div').style.maskImage = 'url("my_mask.png")';
<button onclick='my_function()'>Click Here</button>
<script>
function my_function() {
document.getElementById('my_div').style.maskImage = 'url("my_mask.png")';
}
</script>
CSS Notes:
- The “inherit”, “initial” and “unset” keywords can be used with any CSS property to set its value
- In CSS there are many ways to express a color value in a property
We’d like to acknowledge that we learned a great deal of our coding from W3Schools and TutorialsPoint, borrowing heavily from their teaching process and excellent code examples. We highly recommend both sites to deepen your experience, and further your coding journey. We’re just hitting the basics here at 1SMARTchicken.