clip-path
The clip-path presentation attribute defines or associates a clipping path with the element it is related to.
The clip-path presentation attribute defines or associates a clipping path with the element it is related to.
[!NOTE] As a presentation attribute,
clip-pathalso has a CSS property counterpart: clip-path. When both are specified, the CSS property takes priority.
You can use this attribute with the following SVG elements:
- a
- circle
- clipPath
- ellipse
- g
- image
- line
- marker
- mask
- path
- pattern
- polygon
- polyline
- rect
- svg
- symbol
- text
- use
Example
```css hidden html, body, svg { height: 100%; }
```html
<svg viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
<clipPath id="myClip" clipPathUnits="objectBoundingBox">
<circle cx=".5" cy=".5" r=".5" />
</clipPath>
<!-- Top-left: Apply a custom defined clipping path -->
<rect
x="1"
y="1"
width="8"
height="8"
stroke="green"
clip-path="url(#myClip)" />
<!-- Top-right: Apply a CSS basic shape on a fill-box
geometry. This is the same as having a custom clipping
path with a clipPathUnits set to objectBoundingBox -->
<rect
x="11"
y="1"
width="8"
height="8"
stroke="green"
clip-path="circle() fill-box" />
<!-- Bottom-left -->
<rect
x="1"
y="11"
width="8"
height="8"
stroke="green"
clip-path="circle() stroke-box" />
<!-- Bottom-right: Apply a CSS basic shape on a view-box
geometry. This is the same as having a custom clipping
path with a clipPathUnits set to userSpaceOnUse -->
<rect
x="11"
y="11"
width="8"
height="8"
stroke="green"
clip-path="circle() view-box" />
</svg>
100%
Usage notes
| Value |
<url> | [ basic-shape ||
<geometry-box> ] | none
|
|---|---|
| Default value | none |
| Animatable | Yes |
- \
- : An extra information to tell how a basic-shape is applied to an element:
fill-boxindicates to use the object bounding box;stroke-boxindicates to use the object bounding box extended with the stroke;view-boxindicates to use the nearest SVG viewport as the reference box.
[!NOTE] For more details on the clip-path syntax, see the CSS property clip-path reference page.
Specifications
Browser compatibility
See also
- CSS clip-path property
- Introduction to CSS clipping