宽度

**width** CSS 属性设置元素的宽度。默认情况下,它设置 内容区域 的宽度,但如果 box-sizing 设置为 border-box,则它设置 边框区域 的宽度。

试一试

只要 width 的值保持在 min-widthmax-width 定义的值范围内,指定的 width 值就会应用于内容区域。

  • 如果 width 的值小于 min-width 的值,则 min-width 会覆盖 width
  • 如果 width 的值大于 max-width 的值,则 max-width 会覆盖 width

注意:作为几何属性,width 也适用于 <svg><rect><image><foreignObject> SVG 元素,其中 auto 会解析为 <svg>100% 和其他元素的 0,百分比值相对于 <rect> 的 SVG 视口宽度。CSS width 属性值会覆盖在 SVG 元素上设置的任何 SVG width 属性值。

语法

css
/* <length> values */
width: 300px;
width: 25em;
width: anchor-size(--myAnchor inline, 120%);
width: minmax(100px, anchor-size(width));

/* <percentage> value */
width: 75%;

/* Keyword values */
width: max-content;
width: min-content;
width: fit-content;
width: fit-content(20em);
width: auto;
width: stretch;

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

<length>

将宽度定义为距离值。

<percentage>

将宽度定义为 包含块 宽度的百分比。

auto

浏览器将计算并为指定的元素选择一个宽度。

max-content

内在首选宽度。

min-content

内在最小宽度。

fit-content

使用可用空间,但不超过 max-content,即 min(max-content, max(min-content, stretch))

fit-content(<length-percentage>)

使用 fit-content 公式,其中可用空间被指定的参数替换,即 min(max-content, max(min-content, <length-percentage>))

stretch

将元素的 边距盒 的宽度设置为其 包含块 的宽度。它试图使边距盒填充包含块中的可用空间,因此在某种程度上类似于 100% 的行为,但将结果大小应用于边距盒,而不是由 box-sizing 确定的盒子。

注意:要检查浏览器对 stretch 值使用的别名及其实现状态,请参阅 浏览器兼容性 部分。

无障碍访问

确保设置了 width 的元素在页面缩放以增加文本大小时不会被截断和/或不会遮挡其他内容。

正式定义

初始值auto
应用于所有元素,但未替换的内联元素、表格行和行组除外
继承
百分比指的是包含块的宽度
计算值百分比或 auto 或绝对长度
动画类型长度 (length)、(百分比) 或 calc();

正式语法

width = 
auto |
<length-percentage [0,∞]> |
min-content |
max-content |
fit-content( <length-percentage [0,∞]> ) |
<calc-size()>

<length-percentage> =
<length> |
<percentage>

<calc-size()> =
calc-size( <calc-size-basis> , <calc-sum> )

<calc-size-basis> =
<intrinsic-size-keyword> |
<calc-size()> |
any |
<calc-sum>

<calc-sum> =
<calc-product> [ [ '+' | '-' ] <calc-product> ]*

<calc-product> =
<calc-value> [ [ '*' | '/' ] <calc-value> ]*

<calc-value> =
<number> |
<dimension> |
<percentage> |
<calc-keyword> |
( <calc-sum> )

<calc-keyword> =
e |
pi |
infinity |
-infinity |
NaN

示例

默认宽度

css
p.goldie {
  background: gold;
}
html
<p class="goldie">The MDN community writes really great documentation.</p>

使用像素和 em 的示例

css
.px_length {
  width: 200px;
  background-color: red;
  color: white;
  border: 1px solid black;
}

.em_length {
  width: 20em;
  background-color: white;
  color: red;
  border: 1px solid black;
}
html
<div class="px_length">Width measured in px</div>
<div class="em_length">Width measured in em</div>

百分比示例

css
.percent {
  width: 20%;
  background-color: silver;
  border: 1px solid red;
}
html
<div class="percent">Width in percentage</div>

使用“max-content”的示例

css
p.maxgreen {
  background: lightgreen;
  width: max-content;
}
html
<p class="maxgreen">The MDN community writes really great documentation.</p>

使用“min-content”的示例

css
p.minblue {
  background: lightblue;
  width: min-content;
}
html
<p class="minblue">The MDN community writes really great documentation.</p>

规范

规范
CSS 盒模型模块级别 4
# width-height-keywords
CSS 盒模型模块级别 4
# sizing-values

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅