clip-path

**clip-path** CSS 属性创建一个剪裁区域,该区域设置元素的哪个部分应该显示。区域内的部分将显示,而区域外的部分将隐藏。

试试看

语法

css
/* 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: ellipse(50px 60px at 0 10% 20%);
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"
);
clip-path: rect(5px 5px 160px 145px round 20%);
clip-path: xywh(0 5px 100% 75% round 15% 0);

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

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

clip-path 属性指定为一个或多个以下值的组合。

Values(值)

<clip-source>

一个引用 SVG <clipPath> 元素的 url()

<basic-shape>

一个形状,其大小和位置由 <geometry-box> 值定义。如果没有指定几何体盒子,则 border-box 将用作参考盒子。以下其中之一:

inset()

定义一个内嵌矩形。

circle()

使用半径和位置定义一个圆形。

ellipse()

使用两个半径和位置定义一个椭圆形。

polygon()

使用 SVG 填充规则和一组顶点定义一个多边形。

path()

使用可选的 SVG 填充规则和 SVG 路径定义来定义一个形状。

rect()

使用指定参考框边缘的距离定义一个矩形。

shape()

使用可选的 SVG 填充规则和用于线条、曲线和圆弧的形状命令定义一个形状。

xywh()

使用从参考框的顶部和左侧边缘指定的距离以及矩形的指定宽度和高度定义一个矩形。

<geometry-box>

如果与 <basic-shape> 结合使用,此值定义基本形状的参考框。如果单独指定,它会导致指定框的边缘(包括任何角形,例如 border-radius)成为剪裁路径。几何体框可以是以下值之一:

margin-box

使用 边距框 作为参考框。

border-box

使用 边框框 作为参考框。

padding-box

使用 填充框 作为参考框。

content-box

使用 内容框 作为参考框。

fill-box

使用对象边界框作为参考框。

stroke-box

使用描边边界框作为参考框。

view-box

使用最近的 SVG 视口作为参考框。如果为创建 SVG 视口的元素指定了 viewBox 属性,则参考框位于由 viewBox 属性建立的坐标系的原点,并且参考框的大小设置为 viewBox 属性的宽度和高度值。

none

不创建剪裁路径。

注意: 计算出的值除none 外,都会创建新的堆叠上下文,就像 CSS opacity 的值不是 1 时一样。

正式定义

初始值none
应用于所有元素;在 SVG 中,它应用于容器元素,但不包括 <defs> 元素和所有图形元素
继承
百分比如果指定,则引用参考框,否则引用边框框
计算值按指定值,但 url() 值已变为绝对值
动画类型是,如 <basic-shape> 指定的那样,否则否

正式语法

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

<clip-source> =
<url>

<geometry-box> =
<shape-box> |
fill-box |
stroke-box |
view-box

<url> =
<url()> |
<src()>

<shape-box> =
<visual-box> |
margin-box

<url()> =
url( <string> <url-modifier>* ) |
<url-token>

<src()> =
src( <string> <url-modifier>* )

<visual-box> =
content-box |
padding-box |
border-box

示例

HTML 和 SVG 的比较

css
html,
body {
  height: 100%;
  box-sizing: border-box;
  background: #eee;
}

.grid {
  width: 100%;
  height: 100%;
  display: flex;
  font: 1em monospace;
}

.row {
  display: flex;
  flex: 1 auto;
  flex-direction: row;
  flex-wrap: wrap;
}

.col {
  flex: 1 auto;
}

.cell {
  margin: 0.5em;
  padding: 0.5em;
  background-color: #fff;
  overflow: hidden;
  text-align: center;
  flex: 1;
}

.note {
  background: #fff3d4;
  padding: 1em;
  margin: 0.5em 0.5em 0;
  font: 0.8em sans-serif;
  text-align: left;
  white-space: nowrap;
}

.note + .row .cell {
  margin-top: 0;
}

.container {
  display: inline-block;
  border: 1px dotted grey;
  position: relative;
}

.container::before {
  content: "margin";
  position: absolute;
  top: 2px;
  left: 2px;
  font: italic 0.6em sans-serif;
}

.view-box {
  box-shadow:
    1rem 1rem 0 #efefef inset,
    -1rem -1rem 0 #efefef inset;
}

.container.view-box::after {
  content: "view-box";
  position: absolute;
  left: 1.1rem;
  top: 1.1rem;
  font: italic 0.6em sans-serif;
}

.cell span {
  display: block;
  margin-bottom: 0.5em;
}

p {
  font-family: sans-serif;
  background: #000;
  color: pink;
  margin: 2em;
  padding: 3em 1em;
  border: 1em solid pink;
  width: 6em;
}

.none {
  clip-path: none;
}
.svg {
  clip-path: url(#myPath);
}
.svg2 {
  clip-path: path(
    "M15,45 A30,30,0,0,1,75,45 A30,30,0,0,1,135,45 Q135,90,75,130 Q15,90,15,45 Z"
  );
}
.shape1 {
  clip-path: circle(25%);
}
.shape2 {
  clip-path: circle(25% at 25% 25%);
}
.shape3 {
  clip-path: fill-box circle(25% at 25% 25%);
}
.shape4 {
  clip-path: stroke-box circle(25% at 25% 25%);
}
.shape5 {
  clip-path: view-box circle(25% at 25% 25%);
}
.shape6 {
  clip-path: margin-box circle(25% at 25% 25%);
}
.shape7 {
  clip-path: border-box circle(25% at 25% 25%);
}
.shape8 {
  clip-path: padding-box circle(25% at 25% 25%);
}
.shape9 {
  clip-path: content-box circle(25% at 25% 25%);
}

.defs {
  width: 0;
  height: 0;
  margin: 0;
}

pre {
  margin-bottom: 0;
}

svg {
  margin: 1em;
  font-family: sans-serif;
  width: 192px;
  height: 192px;
}

svg rect {
  stroke: pink;
  stroke-width: 16px;
}

svg text {
  fill: pink;
  text-anchor: middle;
}

svg text.em {
  font-style: italic;
}

完整示例

HTML

html
<img id="clipped" src="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="rect(10px 10px 180px 220px round 20px)">rect</option>
  <option value="xywh(0 20% 90% 67% round 0 0 5% 5px)">xywh</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

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

结果

规范

规范
CSS 遮罩模块级别 1
# the-clip-path
CSS 形状模块级别 1
# supported-basic-shapes

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅