CSS’clip-pathproperty is your ticket to shape-shifting the monotonous, boxy layouts traditionally associated with flat, responsive design.You will begin to think outside the box, literally, and hexagons, stars and octagons will begin to take form on your web pages. Once you get your hands dirty withclip-path, there’s no end to the shapes you can generate, simply by tweaking a few values.

While the focus of this article is onclip-pathusing polygons with CSS, all of the demos provide a reference to an inline SVG, in order to gain additional support on Firefox. Generating a responsive SVG clipped shape is trivial once you have created a responsive shape with CSS’clip-path. We’ll look at this in detail later.

Clip-Path, In A Nutshell

Clipping, with theclip-pathproperty, is akin to cutting a shape (like a circle or a pentagon) from a rectangular piece of paper. The property belongs to the “CSS Masking Module Level 1” specification. The spec states, “CSS masking provides two means for partially or fully hiding portions of visual elements: masking and clipping”.

The first part, i.e. masking, has to do with using a graphical element, such as a PNG image, CSS gradient or SVG element, as a mask to conceal sections of another element.

The second part, i.e.clip-path, involves a closed vector path, which could be a basic shape defined in CSS or an SVG using theclipPathtag. The region inside this path is displayed, and everything beyond or outside it is clipped out.

Note:Masking is beyond the scope of this article, butCSS-TricksandHTML5 Rockshave more information.

Below is a simple visualization of howclip-pathworks:

Note:The demos in this article, including the one above, will work in Firefox and in WebKit and Blink browsers, including Chrome, Safari and Opera.

Clip-Path Is Not Clip

There is anolder CSS 2.1clipproperty, which is rather restrictive, notably because it supports only rectangular shapes. It has beendeprecated in favor ofclip-path.

Articles about clipping that use the deprecated syntax feature code that looks like this:

.element{clip:rect(30px, 30px, 20px, 20px);}

Support For Clip-Path

In August 2014, the “CSS Masking Module” was published as a “Candidate Recommendation,” which is a step up from the earlier “Last Call Working Draft” stage. Before we look at browser support, it’s important to consider the multiple ways in whichclip-pathcan be applied to an element, because browser support varies for each method.

There are two ways to useclip-path:

with CSS

Basic shapes from the “CSS Shapes Module” provide a convenient way to useclip-path. The different shapes available arepolygon,circle,ellipseandinset;insetis for rectangular shapes.

with SVG

One can, alternatively, create a shape using SVG and then clip an element to this shape via the URL syntax. There are two ways to do this:

with a reference to an inline SVG (i.e. the SVG markup exists on the page itself),

with a reference to an external SVG document.

In both cases, theclipPathelement within the SVG is used to wrap the element that determines the clipping path, be it a circle, polygon, path or other element. Compare the demo below in Firefox and in a WebKit or Blink browser such as Chrome to spot the differences. Square images imply a lack of browser support.

Note: The third image does not show up in Safari. Despite extensive debugging, I’m unable to resolve the issue. I’d appreciate a note in the comments section if you come across the solution.

As you may have gathered from observing the demo above in different browsers,support for clipping pathsis quirky and currently depends on the means by which you choose to clip an element:

with CSS: Chrome 24+, Safari 7+, Opera 15+, iOS 7.1+, Android 4.4+, Opera Mobile 24+

(Note that all supported browsers currently require the-webkitvendor prefix.)

with SVG: all of the browsers listed above and Firefox 3.5+

Theclip-pathproperty is not yet supported in Internet Explorer but is currentlyunder considerationas part of the “Masking Module.”

Note:There is a caveat with support for SVG clipping path. Modern WebKit and Blink browsers support clipping paths with SVGs only if they are declared inline (i.e. within the document). References to external SVGs are supported only in Firefox, as evidenced in the demo above. The Chromium project istracking this bug.

Let’s examine theadvantages of CSS versus SVGwithclip-path.

ADVANTAGES OF CSS

The lucid syntax is easy to grasp due to the relative simplicity of basic shapes.

Responsiveness is easily achieved with relative units, such as percentages.

ADVANTAGES OF SVG

Browser support is better, with the addition of Firefox.

You can clip with complex shapes, multiple shapes and text.

While CSS offers abackground-clipproperty that provides us with some options (including a non-standard way to clip text), neitherbackground-clipnor CSS’clip-pathmatch what SVG clipping can achieve in modern browsers. Getting acquainted withclip-pathvia CSS, however, is less intimidating (especially if you aren’t familiar with manipulating SVGs) and will prepare you for the intricacies of clipping paths with SVG, as well as the “CSS Shapes Module,” where content aligns itself to the shape of an element.

Note:If you can’t wait to delve into the matrix of clipping with SVG,Sara Soueidan’s overviewis a good starting point.

Let’s look at thepros and consof usingclip-pathto progressively enhance our designs.

PROS

Browsers that don’t support theclip-pathproperty will ignore it. If you use it with care, users on non-supporting browsers won’t suspect a thing!

Once a clipping-path shape is generated, the specification states that pointer events must not be dispatched outside the clipping area (which is ideal). So, the click event isrestricted to the shape and its outer boundary. We will look at this in the demos below.

You can use percentages or any length unit, such as pixels or ems, to define your coordinates with basic shapes using CSS. Fluid units such as percentages can be used to create responsive shapes, perfect for adaptive layouts.

CONS

All borders, shadows and outlinesoutside the clipping region will be clipped. You can’t add a border and expect it to be honored. We’ll look at some alternatives below.

The specification has not yet reached the “Recommendation” stage, so there’s always a chance that the syntax will change in the interim.

A few bugs have been reported withclip-pathand 3D transforms, transitions and opacity, which are covered in the demos below. Be aware of these, and avoid combining properties that replicate these bugs.

Clip-Path With Polygons: Usage And Syntax

The demos below focus on using different kinds of polygons in a design. The syntax for the other basic shapes (i.e. inset, circle and ellipse) is quite simple, and you can go only so far with them. Polygons, however, open the door to a practically infinite numbers of shapes.

The syntax for a basic polygon shape is this:

.element{clip-path:polygon(x1 y1, x2 y2, x3 y3, ...);}

Each argument pair in the list represents the x-axis and y-axis coordinates of that particular vertex of the polygon.

Here’s how we’d write it in the real world (minus the currently supported WebKit-prefixed version):

.element{clip-path:polygon(0 100%, 0 0, 100% 0, 80% 100%);}

Let’s add support for Firefox with a reference to an inline SVG:

.element{clip-path:url("#clip-shape");}

Here’s how our selector will finally look, with cross-browser support:

.element{-webkit-clip-path:polygon(0 100%, 0 0, 100% 0, 80% 100%);clip-path:polygon(0 100%, 0 0, 100% 0, 80% 100%);-webkit-clip-path:url("#clip-shape");/* required for Webkit/Blink browsers if you're using only inline SVG clipping paths, but not CSS clip-path */clip-path:url("#clip-shape");}

Below is the code for the inline SVG, which we will need to insert anywhere in the markup.

Here is the final demo.

You can create a responsive SVG clipping path in the following manner:

Set the width and height of the SVG to0.

Set an ID on theclipPathelement inside the SVG, which can then be referenced with CSS. You can use inline or external SVG, keeping in mind the browser support mentioned above.

Reuse the percentage coordinate values of the polygon defined with CSSclip-path. Just divide them by 100 and add as unitless polygon points to the SVG.

Set the value of theclipPathUnitsattribute toobjectBoundingBox, so that the clipping path honors the boundaries of the HTML element that references it.

Dudley Storey has moreon this process.

Let’s look at a demo to understandhow to plot coordinates for a polygon.

Below we have an image that is clipped. The background color represents the dimensions of the original image. The black boxes with the coordinates are simply absolutely positioned divs whose locations match the polygon’s vertices in percentages. You will see that they maintain their positions, even if you resize your browser window to a narrow width (for example, 400 pixels or greater).

Real-World Examples With Clip-Path

Note:Every demo in this article usesclip-pathwith CSS but also has inline SVG in the markup with a class ofclip-svg, which simply resets the width and height of the SVG to0. You could, alternatively, remove the class and set the width and height attributes directly in the SVG markup.

EXAMPLE 1: CLIP AN IMAGE TO VARIOUS POLYGON SHAPES

In case you need a quick definition of a polygon, it’s a 2D shape that’s closed and consists of straight lines.

Therefore, a shape cannot be a polygon if it has curves, is open or has fewer than three lines. Some famous polygons in history are triangles, quadrilaterals, pentagons and hexagons. Even star shapes are polygons, since the boundaries of a polygon can cross each other.

Note:The images in the demo are responsive. By using the good ol’ responsive image solution ofimg { max-width: 100%; height: auto; }and adaptive clipping paths via CSS and SVG, we make our polygons blissfully scale up and down.

This demo is the result of an exercise to understand plotting coordinates to make polygon shapes. I’ve added several shapes that you can use for your designs in the demo below. On hovering over each image, you will see the aspect ratio of the original image.

Nothing beats the exceptionalClippy, a GUI tool by Bennett Feely to visualize shapes. All coordinates for all of the existing shapes are provided in percentages, and there’s also a custom polygon option. This one’s a game-changer. You can use Clippy to generate clipped shapes and create SVGs for yourself based on them, for better browser support.

EXAMPLE 2: ANIMATE A BASIC SHAPE WITH CSS TRANSITION

Hover over the purple hexagon. It transforms to an octagon. However, the CSS transition specified has not taken effect.

The reason for this is explained inSara Soueidan’s article on animating CSS shapes: “The number of points defining the final shape must be the same as the number of points defining the initial shape.” Makes perfect sense!

Because a hexagon has six pairs of coordinate points, let’s add two pairs through duplication to make them eight, to match the number of pairs for an octagon. These duplicated pairs won’t affect the shape of the hexagon.

This is the declaration for a hexagon in the form of a default polygon with six pairs of coordinate points:

clip-path:polygon(50% 0%, 100% 25%, 100% 75%, 50% 100%, 0% 75%, 0% 25%);

And this is the declaration for a hexagon in the form of a polygon with eight pairs of coordinates, the first two of which have been duplicated:

clip-path:polygon(50% 0%, 50% 0%, 100% 25%, 100% 25%, 100% 75%, 50% 100%, 0% 75%, 0% 25%);

Now the transition will be smooth as the shapes transform, as seen in the demo below.

Note:For browsers that support clipping paths only with SVG (currently Firefox), we need to add a SMIL animation to obtain a seamless transition on hover. According to the SMIL specification, declarative animations can be used to animate paths and polygon points in SVG, which is currently impossible with CSS.

Keep in mind that some people arediscussing deprecating SMIL in Chrome and Chromiumand focusing on implementing theWeb Animations API, which is unfortunately at the early draft stage.

In the demo below (background image courtesy ofmorgueFile), you can see that we have animated the polygon points between themouseoverandmouseoutevents over a duration of 0.2 seconds. Look for thetag in the SVG markup.

EXAMPLE 3: ADD A BORDER TO A CLIPPED OBJECT

To make a long story short, borders, outlines and box-shadows that lie outside the clipping region are removed.

I was a little saddened by this, and I pinged the W3C members on the working group for CSS. However, the conclusion is that there’s no way to do this when you’re using basic shapes.Dirk Schulzeresponded to my query: “Yes, all drawing operations belonging to the element get clipped. This includes outlines and borders.”

See the demo below. Hover over the rhomboid with a partial border to see the original, unclipped version with the entire border.

Of course, we can always use a CSS hack to get a border, which is what I finally resorted to — good ol’ generated content.

The demo below creates a copy of the element via a pseudo-element (content:after) and absolutely positions it. This creates the illusion of a border, enabling us to simulate interesting effects, such as the gradient border seen in the second octagon and the inset box-shadow via a CSS filter on the third one (not very pretty, but functional). Note that CSS filters currently work only in Firefox and in WebKit and Blink browsers.

EXAMPLE 4: USE CLIP-PATH TO CREATE A DIAMOND GRID OVER A RHOMBUS

Below is the image we will use.

(View large version)

This is the effect we’re aiming for. Upon hovering over the bottom three boxes, you’ll see the background color fade to reveal the background.

(View large version)

The actual size of the image is 600 × 600 pixels. Thus, let’s start with four empty divs of 300 pixels each and apply the same background image to them. Let’s add a parent wrapper of 604 pixels and lay out the images with theinline-blockproperty.

(View large version)

Let’s now change the value of thebackground-positionproperty for each image totop,left,rightandbottom, respectively.

(View large preview)

Let’s clip each box into the shape of a rhombus. We will overlay an absolutely positioned layer on each of the bottom three images, with some text.

(View large version)

Now we will move the images into rows — the second and third image into one row, and the first and fourth into their own individual rows.

(View large version)

Finally, we will use negative margins to push up the second and third rows, so that they are laid out as in the final demo below. We can remove the width value of 604 pixels on the parent wrapper, and we can structure our media query so that the four diamond boxes move from a stacked layout on small screens to inline blocks on larger ones.

While working on this demo, I noticed a bug in Chrome with pointer events being dispatched outside the clipped region, whichviolates the specification: “By default, pointer events must not be dispatched on the clipped-out (non-visible) regions of a shape.” I havefiled the bug. The issue with this demo was solved by using thepointer-eventsproperty with a value ofnoneon the overlay. Alternatively, you could apply the sameclip-pathvalue to the overlay to resolve the issue.

Due to the negative margins applied, this demo would look odd in browsers that don’t supportclip-path. You would have to use some sort of feature detection to apply the margins (although I haven’t experimented with this) or the@supportsCSS feature query, although I wouldn’t recommend the latter in production code.

EXAMPLE 5: CREATE A DUMMY PROFILE PAGE WITH HEXAGONS

Our final page should look like this:

(View large version)

We’ll start by adding a background image of hexagon tiles to the body (the image courtesy ofSubtle Patterns).

The hexagonclip-pathvalues can be obtained from one of the demos above or with the Clippy tool.

The first hexagon uses a background image (because we’re blending a dull maroon into the background using thebackground-blend-modeproperty). Using generated content, an absolutely positioned overlay is clipped to a maroon triangle shape, which you can see on the bottom. It disappears on hover.

The second hexagon, with the word “work,” simply has a dark grey background that changes on hover.

The third hexagon has a gradient border, similar to the one in the demo on creating borders withclip-path.

The hexagons stack on small screens and are vertically centered on larger ones. I’ve used a combination ofdisplay: tableand the absolute centering transforms hack — of course, you could use flexbox, floats or whatever else floats your layouting boat.

Here’s the final demo.

Idiscovered a bugwithclip-pathwhile creating this demo. Altering the value ofopacityin combination with the CSS transition causes a flicker and artifacts on the page. Be aware of this if you’re usingclip-pathto progressively enhance a design.

There is also a bug withclip-pathand thebackface-visibilityproperty when set to hidden. Thisbug is documented in Chromium’s issue tracker and I have been able to replicate it using the basic shape syntax in Chrome on Linux. Keep this in mind if you’re using aclip-pathshape to do a cool 3D flip or anything that uses CSS 3D transforms.

While clipping with SVG wins hands down for its flexibility and options, nothing beats the ease with which elements can be clipped with CSS. In fact, the same polygon coordinates can be effortlessly recycled to create responsive SVG for even better browser support. Withclip-path, you can dramatically alter the look and feel of a page, without having to worry much about non-supporting browsers, where it will gracefully degrade. If you choose to useclip-pathfor design enhancements, keep an eye on the specification as it advances towards “Recommendation” status.

Resources, Tools And Inspiration

“CSS Masking Module Level 1,” W3C

This is the ultimate source of truth and the best reference, when in doubt.

“Clipping in CSS and SVG: Theclip-pathProperty andElement,” Sara Soueidan

Soueidan has the definitive guide to clipping paths. While the focus is largely on SVG, this article is a fantastic introduction, with plenty of information for both intermediate and advanced readers.

“clip-path,” Sara Soueidan, Codrops

Soueidan’s well-researched and comprehensive article over on Codrops breaks down a fairly complicated module into something that is easy to understand and assimilate.

“Clipping and Masking in CSS,” Chris Coyier, CSS-Tricks

Coyier’s article, peppered with several helpful demos, explains both clipping and masking.

Clippy

Bennett Feely’s fab clip-path maker can generate a plethora of predefined and custom polygon shapes, circles and ellipses for CSS’clip-path. All values are in percentages and, hence, useful for responsive layouts.

Clip Path Generator

CSS Plant offers a rather comprehensive graphical interface to clip or mask an element. Cross-browser support is provided for Firefox, Chrome, Safari and old iOS. Clips are in pixels, not percentages.

Species in Pieces

So breathtaking it borders on the spiritual, this showcase of 30 endangered species was crafted entirely with CSS’clip-path, without a hint of canvas or WebGL. View it in a WebKit or Blink browser until the other ones catch up.

(ds, il, al)