border-block - CSS：层叠样式表 | MDN

切换侧边栏

主题

跟随系统
浅色
深色

中文 (简体)

记住语言了解更多

border-block

基线广泛可用

自 2021年4月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

CSS 属性 border-block 为简写属性，用于在样式表中的某处同时设置逻辑块向边框的各属性值。

本文内容

尝试一下

border-block: solid;
writing-mode: horizontal-tb;

border-block: dashed red;
writing-mode: vertical-rl;

border-block: 1rem solid;
writing-mode: horizontal-tb;
direction: rtl;

<section class="default-example" id="default-example">
  <div class="transition-all" id="example-element">
    This is a box with a border around it.
  </div>
</section>

#example-element {
  background-color: #eee;
  color: #8b008b;
  padding: 0.75em;
  width: 80%;
  height: 100px;
  unicode-bidi: bidi-override;
}

border-block 可用于设置 border-block-width、border-block-style 和 border-block-color 中至少一个属性的值，且一次性设置块首和块末。此属性所对应的实体边框取决于元素的书写模式、行内方向和文本朝向。根据 writing-mode、direction 和 text-orientation 所定义的值，此属性对应于 border-top 和 border-bottom，或者 border-right 和 border-left 属性。

另一方向的边框可用 border-inline 设置，此属性会设置 border-inline-start 和 border-inline-end。

属性构成

此属性为下列 CSS 属性的简写属性：

语法

css
border-block: 1px;
border-block: 2px dotted;
border-block: medium dashed blue;

/* 全局值 */
border-block: inherit;
border-block: initial;
border-block: revert;
border-block: revert-layer;
border-block: unset;

取值

border-block 属性可用下列值中的至少一个指定，次序任意：

<'border-width'>

边框宽度。见 border-width。

<'border-style'>

边框线型。见 border-style。

<'color'>

边框颜色。见 color。

形式定义

初始值适用元素是否是继承属性计算值动画类型

该简写所对应的每个属性：

border-block-width: 该简写所对应的每个属性：
- border-block-start-width: medium
- border-block-end-width: medium
border-block-style: 该简写所对应的每个属性：
- border-block-start-style: none
- border-block-end-style: none
border-block-color: 该简写所对应的每个属性：
- border-block-start-color: currentcolor
- border-block-end-color: currentcolor

所有元素

否

该简写所对应的每个属性：

border-block-width: 该简写所对应的每个属性：
- border-block-start-width: absolute length; 0 if the border style is none or hidden
- border-block-end-width: absolute length; 0 if the border style is none or hidden
border-block-style: 该简写所对应的每个属性：
- border-block-start-style: as specified
- border-block-end-style: as specified
border-block-color: 该简写所对应的每个属性：
- border-block-start-color: 颜色计算值
- border-block-end-color: 颜色计算值

该简写所对应的每个属性：

border-block-width: 该简写所对应的每个属性：
- border-block-start-width: 按计算值的类型
- border-block-end-width: 按计算值的类型
border-block-style: 离散值
border-block-color: 该简写所对应的每个属性：
- border-block-start-color: 按计算值的类型
- border-block-end-color: 按计算值的类型

形式语法

border-block =
<'border-block-start'>

<border-block-start> =
<line-width> ||
<line-style> ||
<color>

<line-width> =
<length [0,∞]> |
hairline |
thin |
medium |
thick

<line-style> =
none |
hidden |
dotted |
dashed |
solid |
double |
groove |
ridge |
inset |
outset
此语法反映了基于 CSS Borders and Box Decorations Module Level 4 的最新标准。并非所有浏览器都已实现全部内容。有关支持信息，请参阅浏览器兼容性。

示例

竖排文本的边框

HTML

html
<div>
  <p class="exampleText">示例文本</p>
</div>

CSS

css
div {
  background-color: yellow;
  width: 120px;
  height: 120px;
}

.exampleText {
  writing-mode: vertical-rl;
  border-block: 5px dashed blue;
}

结果

规范

CSS Logical Properties and Values Module Level 1
# propdef-border-block

浏览器兼容性

启用 JavaScript 以查看此浏览器兼容性表。

参见

CSS 逻辑属性与逻辑值
此属性对应的实体边框属性：border-top、border-right、border-bottom 或 border-left
writing-mode、direction、text-orientation

帮助改进 MDN

此页面对您有帮助吗？

是否

了解如何参与贡献

此页面最后更新于 2025年11月10日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题