CSS Reference

Quick Reference

The mask-image property specifies an imageCSS 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 valuenone
Inherited valuesno
Can it be animated?no

These are the allowed values.

ValueDescription
noneDefault
imageAn image to use as the mask layer
urlA url reference to an image or an SVG element
initialSets this property to its default value
inheritInherits 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:


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.