mozilla
Your Search Results

    clip-path

    This article is in need of an editorial review.

    This is an experimental technology
    Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the spec changes.

    Summary

    The clip-path CSS property prevents a portion of an element from getting displayed by defining a clipping region to be displayed i.e, only a specific region of the element is displayed. The clipping region is a path specified as a URL referencing an inline or external SVG, or shape method such as circle(). The clip-path property replaces the now deprecated clip property.

    Syntax

    clip-path: none;
    clip-path: url(resources.svg#c1);
    clip-path: polygon(50% 0%, 100% 50%, 50% 100%, 0% 50%)};
    

    Values

    <clip-source>
    Represents a URL referencing a clip path element.
    <basic-shape>
    A basic shape function as defined in the CSS Shapes specification. A basic shape makes use of the specified reference box to size and position the basic shape. If no reference box is specified, the border-box will be used as reference box.
    <geometry-box>

    If specified in combination with a <basic-shape>, it provides the reference box for the basic shape. If specified by itself, it uses the edges of the specified box including any corner shaping (e.g. defined by border-radius) as clipping path.

    fill-box

    Uses the object bounding box as reference box.

    stroke-box

    Uses the stroke bounding box as reference box.

    view-box

    Uses the nearest SVG viewport as reference box. If a viewBox attribute is specified for the SVG viewport creating element, the reference box is positioned at the origin of the coordinate system established by the viewBox attribute and the dimension of the reference box is set to the width and height values of the viewBox attribute.

    none
    There is no clipping path created.

    Formal syntax

    <clip-source> | [ <basic-shape> || <geometry-box> ] | none

    where
    <clip-source> = <url>
    <geometry-box> = <shape-box> | fill-box | stroke-box | view-box

    Examples

    /* inline SVG  */
    .target { clip-path: url(#c1); }
    
    /* external SVG */
    .anothertarget { clip-path: url(resources.svg#c1); }
    
    /* circle */
    .circleClass { clip-path: circle(15px at 20px 20px); }

    Specifications

    Specification Status Comment
    CSS Masking Level 1
    The definition of 'clip-path' in that specification.
    Candidate Recommendation Extends its application to HTML elements
    Scalable Vector Graphics (SVG) 1.1 (Second Edition)
    The definition of 'clip-path' in that specification.
    Recommendation Initial definition (applies to SVG Elements only)

    Browser compatibility

    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
    Basic support ? ? ? ? ?
    HTML elements 24 with prefix 3.5 (1.9.1) only URL value ? ? ?
    Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
    Basic support ? ? ? ? ?
    HTML elements ? 1.0 (1.9.1) ? ? ?

    See also

    Document Tags and Contributors

    Last updated by: Sebastianz,
    Hide Sidebar