clip-path

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

/* Keyword values */
clip-path: none;
clip-path: fill-box;
clip-path: stroke-box;
clip-path: view-box;

/* Image values */
clip-path: url(resources.svg#c1);
clip-path: linear-gradient(blue, transparent);

/* Geometry values */
clip-path: inset(100px 50px);
clip-path: circle(50px at 0 100px);
clip-path: polygon(50% 0%, 100% 50%, 50% 100%, 0% 50%);

/* Global values */
clip-path: inherit;
clip-path: initial;
clip-path: unset;

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 element creating the SVG viewport, 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>
<basic-shape> = <inset()> | <circle()> | <ellipse()> | <polygon()>
<geometry-box> = <shape-box> | fill-box | stroke-box | view-box
where 
<inset()> = inset( <shape-arg>{1,4} [round <border-radius>]? )
<circle()> = circle( [<shape-radius>]? [at <position>]? )
<ellipse()> = ellipse( [<shape-radius>{2}]? [at <position>]? )
<polygon()> = polygon( [<fill-rule>,]? [<shape-arg> <shape-arg>]# )
<shape-box> = <box> | margin-box
where 
<shape-arg> = <length> | <percentage>
<shape-radius> = <length> | <percentage> | closest-side | farthest-side
<fill-rule> = nonzero | evenodd
<box> = border-box | padding-box | content-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);
}

Example 1

HTML

<style>
    .svg-clipped {
        clip-path: url(#svgPath);
        clip-path: url(#svgPath);
    }
</style>
<img class="svg-clipped" src="https://pixabay.com/static/uploads/photo/2016/01/17/04/29/rain-drops-1144448_960_720.jpg" alt="Rain Drops">
<svg height="0" width="0">
    <defs>
        <clipPath id="svgPath">
            <path fill="#FFFFFF" stroke="#000000" stroke-width="1.5794" stroke-miterlimit="10" d="M215,100.3c97.8-32.6,90.5-71.9,336-77.6
        c92.4-2.1,98.1,81.6,121.8,116.4c101.7,149.9,53.5,155.9,14.7,178c-96.4,54.9,5.4,269-257,115.1c-57-33.5-203,46.3-263.7,20.1
        c-33.5-14.5-132.5-45.5-95-111.1C125.9,246.6,98.6,139.1,215,100.3z" />
        </clipPath>
    </defs>
</svg>

Result

Specifications

Browser compatibility

[1] Chrome and Opera currently don't support external SVGs.

[2] Gecko currently only implements url() values. Support for basic shapes is tracked in bug 1075457.

See also

• clip-rule, mask, filter
• Applying SVG effects to HTML content
• clip-path SVG attribute