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

rect()

· 52CE 我爱测

**`rect()`** CSS 函数可以创建一个矩形,该矩形位于包含块的顶部和左侧边缘的指定距离处。它是 <basic-shape> 数据类型的基本形状函数。你可以在 CSS 属性中使用 `rect()` 函数,例如 offset-path 创建元素移动的矩形路径,以及在 clip-path 中定义裁剪区域的形状。

rect() CSS 函数可以创建一个矩形,该矩形位于包含块的顶部和左侧边缘的指定距离处。它是 <basic-shape> 数据类型的基本形状函数。你可以在 CSS 属性中使用 rect() 函数,例如 offset-path 创建元素移动的矩形路径,以及在 clip-path 中定义裁剪区域的形状。

语法

offset-path: rect(0 1% auto 3% round 0 1px);
clip-path: rect(50px 70px 80% 20%);

值

内部矩形由四个偏移值定义,从顶边开始顺时针,以及可选的 round 关键字与 border-radius 参数,用于在矩形上添加圆角。每个偏移值可以是 <length>、<percentage>,或关键字 auto。

  • <length-percentage>

    • : 指定矩形的顶部、右侧、底部或左侧边缘与包含块的顶部或左侧边缘的距离的 <length-percentage> 值。第一个(顶部)和第三个(底部)值是相对于包含块的顶部边缘的距离,第二个(右侧)和第四个(左侧)值是相对于包含块的左侧边缘的距离。第二个(右侧)和第三个(底部)值由第四个(左侧)和第一个(顶部)值分别限制,以防止底部边缘越过顶部边缘和右边缘越过左边缘。例如,rect(10px 0 0 20px) 被限制为 rect(10px 20px 10px 20px)。
  • auto

    • : 使其用于的边缘与包含块的相应边缘重合。如果第一个(顶部)或第四个(左侧)值使用了 auto,则 auto 的值为 0;如果用于第二个(右侧)或第三个(底部)值,则 auto 的值为 100%。
  • round <'border-radius'>

    • : 使用与 CSS border-radius 简写属性相同的语法指定矩形的圆角半径。此参数是可选的。

形式语法

示例

使用 rect() 创建 offset-path

在此示例中,offset-path 属性使用 rect() 函数来定义元素移动的路径的形状,这里是一个红色框。展示了三种不同的情况,每种情况下 rect() 函数使用不同的值。方框内的箭头指向方框的右边缘。

<div class="container">
  矩形路径 1
  <div class="path rect-path-1">→</div>
</div>
<div class="container">
  矩形路径 2
  <div class="path rect-path-2">→</div>
</div>
<div class="container">
  矩形路径 3
  <div class="path rect-path-3">→</div>
</div>
.container {
  position: relative;
  display: inline-block;
  width: 200px;
  height: 200px;
  border: 1px solid black;
  margin: 15px;
  text-align: center;
}

.path {
  width: 40px;
  height: 40px;
  background-color: red;
  position: absolute;
  animation: move 10s linear infinite;
}

.rect-path-1 {
  offset-path: rect(50px 150px 200px 50px round 20%);
}

.rect-path-2 {
  offset-path: rect(50px auto 200px 50px round 20%);
}

.rect-path-3 {
  offset-path: rect(50px auto 200px auto);
}

@keyframes move {
  0% {
    offset-distance: 0%;
  }
  100% {
    offset-distance: 100%;
  }
}

结果

使用 rect() 创建 offset-path

  • 路径 1 的矩形指定了相对于包含块的四个边缘(上、右、下和左)的距离。顶部和底部值是相对于包含块的顶部边缘的距离。右侧和左侧值是相对于包含块的左侧边缘的距离。此外,矩形的角被设置为 20% 的圆角,使得红色盒子元素在沿着此路径移动时,会跟随圆角移动。请注意框内箭头沿着矩形路径拐角处的曲线的移动情况。
  • 路径 2 的矩形与路径 1 的矩形类似,只是右侧值为 auto,它等于值 100%。这导致矩形的右边缘与包含块的右边缘对齐,从而创建了一个比路径 1 更宽的矩形。
  • 路径 3 的矩形将左侧和右侧边缘参数都设置为 auto,并省略了 round <'border-radius'> 参数。这会创建一个宽度与包含块相同的矩形,其角是矩形的直角,而不是路径 1 和路径 2 中的圆角。请注意框内箭头在角落的移动情况。

规范

浏览器兼容性

参见

  • basic-shape/inset 函数
  • basic-shape/xywh 函数
  • clip-path 属性
  • offset-path 属性
  • <basic-shape> 数据类型
  • CSS 形状模块
  • 基本形状指南

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

资料来源与适用范围

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

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

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