mozilla
Your Search Results

    mask

    Summary

    The mask element in CSS allows users to alter the visibility of an item by either partially or fully hidding the item. This is accomplished by either masking or clipping the image at specific points.

    Syntax

    /* Keyword values */
    mask: none;
    
    /* Image values */
    mask: url(mask.png);                       /* Pixel image used as mask */
    mask: url(masks.svg#star);                 /* Element within SVG graphic used as mask */
    
    /* Combined values */
    mask: url(masks.svg#star) luminance;       /* Element within SVG graphic used as luminance mask */
    mask: url(masks.svg#star) 40px 20px;       /* Element within SVG graphic used as mask positioned 40px from the top and 20px from the left */
    mask: url(masks.svg#star) 0 0/50px 50px;   /* Element within SVG graphic used as mask with a width and height of 50px */
    mask: url(masks.svg#star) repeat-x;        /* Element within SVG graphic used as horizontally repeated mask */
    mask: url(masks.svg#star) stroke-box;      /* Element within SVG graphic used as mask extending to the box enclosed by the stroke */
    mask: url(masks.svg#star) exclude;         /* Element within SVG graphic used as mask and combined with background using non-overlapping parts */
    
    /* Global values */
    mask: inherit;
    mask: initial;
    mask: unset;
    

    Values

    If the value is a URI value, the element pointed to by the URI is used as an SVG mask.

    <mask-layer>#

    where
    <mask-layer> = <mask-reference> <masking-mode>? || <position> [ / <bg-size> ]? || <repeat-style> || <geometry-box> || [ <geometry-box> | no-clip ] || <compositing-operator>

    where
    <mask-reference> = none | <image> | <mask-source>
    <masking-mode> = alpha | luminance | auto
    <bg-size> = [ <length> | <percentage> | auto ]{1,2} | cover | contain
    <repeat-style> = repeat-x | repeat-y | [repeat | space | round | no-repeat]{1,2}
    <geometry-box> = <shape-box> | fill-box | stroke-box | view-box
    <compositing-operator> = add | subtract | intersect | exclude

    where
    <mask-source> = <url>
    <shape-box> = <box> | margin-box

    where
    <box> = border-box | padding-box | content-box

    Examples

    .target { mask: url(#c1); }
    
    .anothertarget { mask: url(resources.svg#c1); }
    

    Specifications

    Specification Status Comment
    CSS Masking Level 1
    The definition of 'mask' in that specification.
    Candidate Recommendation Extends its usage to HTML elements.
    Extends its syntax by making it a shorthand for the new mask-* properties defined in that specification.
    Scalable Vector Graphics (SVG) 1.1 (Second Edition)
    The definition of 'mask' in that specification.
    Recommendation Initial definition.

    Browser compatibility

    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
    Basic support (for SVG) (Yes) (Yes) [*] ? (Yes) (Yes)
    Applies to HTML Elements Not supported 3.5 (1.9.1) [*] Not supported Not supported Not supported
    Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
    Basic support ? ? ? ? ?

    [*] Starting in Gecko 10.0 (Firefox 10.0 / Thunderbird 10.0 / SeaMonkey 2.7), the default color space when handling masks is sRGB; previously, the default (and only supported color space) was linearRGB. This changes the appearance of mask effects, but brings Gecko into compliance with the second edition of the SVG 1.1 specification.

    See also

    Document Tags and Contributors

    Last updated by: Sebastianz,
    Hide Sidebar