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

border-image-width

· 52CE 我爱测

CSS属性 **`border-image-width`** 指定了 边界图像 (border image) 的宽度

CSS属性 border-image-width 指定了 边界图像 (border image) 的宽度

CSS Demo: border-image-width

border-image-width: 30px;
border-image-width: 15px 40px;
border-image-width: 2.6rem;
border-image-width: 20% 8%;
<section id="default-example">
  <div id="example-element">This is a box with a border around it.</div>
</section>
#example-element {
  width: 80%;
  height: 80%;
  display: flex;
  align-items: center;
  justify-content: center;
  padding: 50px;
  background: #fff3d4;
  color: #000;
  border: 30px solid;
  border-image: url("/shared-assets/images/examples/border-diamonds.png") 30
    round;
  font-size: 1.2em;
}

如果本属性值大于元素的 border-width,边界图像将会向 padding 边缘延展

语法

/* 关键字 */
border-image-width: auto;

/* 长度 */
border-image-width: 1rem;

/* 百分比 */
border-image-width: 25%;

/* 数值 */
border-image-width: 3;

/* 垂直 | 水平 */
border-image-width: 2em 3em;

/* 上 | 横向 | 下 */
border-image-width: 5% 15% 10%;

/* 上 | 右 | 下 | 左 */
border-image-width: 5% 2em 10% auto;

/* 全局值 */
border-image-width: inherit;
border-image-width: initial;
border-image-width: unset;

border-image-width 属性的值可用以下方式进行设定:

  • 当指定 一个 值时,它将作用到 四个方向 ;
  • 当指定 两个 值时,它将分别作用到 垂直方向 和 水平方向 ;
  • 当指定 三个 值时,它将分别作用到 上方、水平方向、和下方;
  • 当指定 四个 值时,它将分别作用到 上方、右方、下方和左方。

取值

  • <长度 - 百分比>
    • : 边界的宽度,可按 <length> 或 <percentage> 指定。百分比是相较于水平(垂直)方向上的边框图像区域宽度(高度)的偏移量,不能为负。
  • <数值>
    • : 边框宽度,指定为 border-width 的相应倍数,不能为负。
  • auto
    • : 将等同于内部对应的 border-image-slice 的宽或高(可用的话)。如果图像没有需要的相应的属性,将相对于 border-width 进行指定。

正式定义

正式语法

示例

Tiling a border image

示例使用了下方 90*90 像素的 ".png" 图像。

因此,每个圆圈为 30*30 像素。

HTML

<p>
  Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy
  eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam
  voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita
  kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
</p>

CSS

p {
  border: 20px solid;
  border-image: url("border.png") 30 round;
  border-image-width: 16px;
  padding: 40px;
}

结果

Tiling_a_border_image

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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