--- title: clip-path slug: Web/CSS/clip-path tags: - CSS - CSS Masking - CSS 属性 - CSS 遮罩 - Web - clip-path - 实验性 - 引用 translation_of: Web/CSS/clip-path ---
{{CSSRef}}

clip-path CSS 属性使用裁剪方式创建元素的可显示区域。区域内的部分显示，区域外的隐藏。

{{EmbedInteractiveExample("pages/css/clip-path.html")}}

语法

/* Keyword values */
clip-path: none;

/* <clip-source> values */
clip-path: url(resources.svg#c1);

/* <geometry-box> values */
clip-path: margin-box;
clip-path: border-box;
clip-path: padding-box;
clip-path: content-box;
clip-path: fill-box;
clip-path: stroke-box;
clip-path: view-box;

/* <basic-shape> values */
clip-path: inset(100px 50px);
clip-path: circle(50px at 0 100px);
clip-path: polygon(50% 0%, 100% 50%, 50% 100%, 0% 50%);
clip-path: path('M0.5,1 C0.5,1,0,0.7,0,0.3 A0.25,0.25,1,1,1,0.5,0.3 A0.25,0.25,1,1,1,1,0.3 C1,0.7,0.5,1,0.5,1 Z');

/* Box and shape values combined */
clip-path: padding-box circle(50px at 0 100px);

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

clip-path属性指定为下面列出的值的一个或多个值的组合.

取值

<clip-source>
用 {{cssxref("<url>")}} 表示剪切元素的路径
{{cssxref("<basic-shape>")}}
一种形状，其大小和位置由<几何盒>值定义。如果没有指定几何框，则边框将用作参考框
<geometry-box>
如果同 <basic-shape> 一起声明，它将为基本形状提供相应的参考框盒。通过自定义，它将利用确定的盒子边缘包括任何形状边角（比如说，被 {{cssxref("border-radius")}} 定义的剪切路径）。几何框盒可以有以下的值中的一个：
margin-box
使用 margin box 作为引用框。
border-box
使用 border box 作为引用框。
padding-box
使用 padding box 作为引用框。
content-box
使用 content box 作为引用框。
fill-box
利用对象边界框作为引用框。
stroke-box
使用笔触边界框（stroke bounding box）作为引用框
view-box
使用最近的 SVG 视口（viewport）作为引用框。如果{{SVGAttr("viewBox")}} 属性被指定来为元素创建 SVG 视口，引用框将会被定位在坐标系的原点，引用框位于由 viewBox 属性建立的坐标系的原点，引用框的尺寸用来设置 viewBox 属性的宽高值。
none
不创建的剪切路径。

Note: A computed value other than none results in the creation of a new stacking context the same way that CSS {{cssxref("opacity")}} does for values other than 1.

正式语法

{{csssyntax}}

例子

HTML 与 SVG 之间的对比

{{EmbedLiveSample("clip-path", "100%", 800, "", "", "example-outcome-frame")}}

完整示例

HTML

<img id="clipped" src="https://mdn.mozillademos.org/files/12668/MDN.svg"
    alt="MDN logo">
<svg height="0" width="0">
  <defs>
    <clipPath id="cross">
      <rect y="110" x="137" width="90" height="90"/>
      <rect x="0" y="110" width="90" height="90"/>
      <rect x="137" y="0" width="90" height="90"/>
      <rect x="0" y="0" width="90" height="90"/>
    </clipPath>
  </defs>
</svg>

<select id="clipPath">
  <option value="none">none</option>
  <option value="circle(100px at 110px 100px)">circle</option>
  <option value="url(#cross)" selected>cross</option>
  <option value="inset(20px round 20px)">inset</option>
  <option value="path('M 0 200 L 0,110 A 110,90 0,0,1 240,100 L 200 340 z')">path</option>
</select>

CSS

#clipped {
  margin-bottom: 20px;
  clip-path: url(#cross);
}

结果

{{EmbedLiveSample("Complete_example", 230, 250)}}

规范

Specification Status Comment
{{SpecName("CSS Masks", "#the-clip-path", 'clip-path')}} {{Spec2('CSS Masks')}} Extends its application to HTML elements
{{SpecName('SVG1.1', 'masking.html#ClipPathProperty', 'clip-path')}} {{Spec2('SVG1.1')}} Initial definition (applies to SVG elements only)

{{cssinfo}}

浏览器兼容性

{{Compat("css.properties.clip-path")}}

参见