大网数据广告活动
Web 标准与前端开发

<clipPath>

· 52CE 我爱测

**`<clipPath>`** SVG 元素定义一条裁剪路径,供 clip-path 属性使用。

<clipPath> SVG 元素定义一条裁剪路径,供 clip-path 属性使用。

裁剪路径限制可应用绘制的区域。从概念上讲,绘图中位于裁剪路径所界定区域之外的部分不会被绘制。

使用上下文

属性

  • clipPathUnits
    • : 定义 <clipPath> 元素内容的坐标系。值类型:userSpaceOnUse | objectBoundingBox;默认值:userSpaceOnUse;动画性:是

DOM 接口

该元素实现了 SVGClipPathElement 接口。

示例

html,
body,
svg {
  height: 100%;
}
<svg viewBox="0 0 100 100">
  <clipPath id="myClip">
    
    <circle cx="40" cy="35" r="35" />
  </clipPath>

  
  <path
    id="heart"
    d="M10,30 A20,20,0,0,1,50,30 A20,20,0,0,1,90,30 Q90,60,50,90 Q10,60,10,30 Z" />

  
  <use clip-path="url(#myClip)" href="#heart" fill="red" />
</svg>
/* 为已实现 r 几何属性的浏览器添加一点 CSS */

@keyframes openYourHeart {
  from {
    r: 0;
  }
  to {
    r: 60px;
  }
}

#myClip circle {
  animation: openYourHeart 15s infinite;
}

示例

裁剪路径在概念上等同于引用元素的自定义视口。因此,它会影响元素的渲染,但不会影响元素的固有几何。被裁剪元素(即通过 clip-path 属性引用 <clipPath> 元素的元素,或引用元素的子元素)的边界框必须与未裁剪时相同。

默认情况下,被裁剪区域不会派发 pointer-events 事件。例如,一个半径为 10 的圆被裁剪为半径为 5 的圆时,在较小半径之外不会接收“click”事件。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。