border-width

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

border-width 简写 CSS 属性设置元素边框的宽度。

试一试

border-width: thick;
border-width: 1em;
border-width: 4px 1.25em;
border-width: 2ex 1.25ex 0.5ex;
border-width: 0 4px 8px 12px;
<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: palegreen;
  color: black;
  border: 0 solid crimson;
  padding: 0.75em;
  width: 80%;
  height: 100px;
}

构成属性

此属性是以下 CSS 属性的简写:

语法

css
/* Keyword values */
border-width: thin;
border-width: medium;
border-width: thick;

/* <length> values */
border-width: 4px;
border-width: 1.2rem;

/* top and bottom | left and right */
border-width: 2px 1.5em;

/* top | left and right | bottom */
border-width: 1px 2em 1.5cm;

/* top | right | bottom | left */
border-width: 1px 2em 0 4rem;

/* Global values */
border-width: inherit;
border-width: initial;
border-width: revert;
border-width: revert-layer;
border-width: unset;

border-width 属性可以指定一个、两个、三个或四个值。

  • 当指定一个值时,它将相同的宽度应用于所有四个边
  • 当指定两个值时,第一个宽度应用于顶部和底部,第二个宽度应用于左侧和右侧
  • 当指定三个值时,第一个宽度应用于顶部,第二个宽度应用于左侧和右侧,第三个宽度应用于底部
  • 当指定四个值时,宽度按顶部右侧底部左侧的顺序(顺时针)应用。

<line-width>

定义边框的宽度,可以是明确的非负<length>,也可以是关键词。如果是关键词,它必须是以下值之一:

  • thin
  • medium
  • thick

注意:由于规范并未定义每个关键词表示的确切厚度,因此使用它们时,具体结果取决于实现。然而,它们总是遵循 thin ≤ medium ≤ thick 的模式,并且在单个文档中,这些值是恒定的。

正式定义

初始值作为简写中的每个属性
应用于所有元素。也适用于 ::first-letter
继承性
计算值作为简写中的每个属性
动画类型作为简写中的每个属性

正式语法

border-width = 
<'border-top-width'>{1,4}

<border-top-width> =
<line-width>

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

示例

值和长度的组合

HTML

html
<p id="one-value">one value: 6px wide border on all 4 sides</p>
<p id="two-values">
  two different values: 2px wide top and bottom border, 10px wide right and left
  border
</p>
<p id="three-values">
  three different values: 0.3em top, 9px bottom, and zero width right and left
</p>
<p id="four-values">
  four different values: "thin" top, "medium" right, "thick" bottom, and 1em
  left
</p>

CSS

css
#one-value {
  border: ridge #cccccc;
  border-width: 6px;
}
#two-values {
  border: solid red;
  border-width: 2px 10px;
}
#three-values {
  border: dotted orange;
  border-width: 0.3em 0 9px;
}
#four-values {
  border: solid lightgreen;
  border-width: thin medium thick 1em;
}
p {
  width: auto;
  margin: 0.25em;
  padding: 0.25em;
}

结果

规范

规范
CSS Backgrounds and Borders Module Level 3
# border-width

浏览器兼容性

另见