浏览器与 Web API / 系统课时
offset、client 与 scroll 尺寸
offset、client 与 scroll 尺寸
本课解决元素“看起来有多宽、内部可用多宽、全部内容实际需要多宽”这三个常见问题。你将用同一组元素对比 offset、client 与 scroll 系列属性,并能根据盒模型、边框和溢出情况选对尺寸 API。
学习目标
- 区分
offsetWidth、clientWidth、scrollWidth的计算边界 - 通过可运行示例验证边框、内边距与溢出内容对结果的影响
- 识别
display: none、滚动条和 CSS 变换带来的边界差异
三组尺寸分别测量什么
这三组属性都返回元素当前的布局尺寸,但观察范围不同。宽度属性与高度属性一一对应:offsetWidth 对应 offsetHeight,clientWidth 对应 clientHeight,scrollWidth 对应 scrollHeight。
| 属性 | 主要范围 | 包含 | 不包含 | 常见用途 |
|---|---|---|---|---|
offsetWidth |
边框盒 | 内容、内边距、边框、占位的滚动条 | 外边距 | 读取元素整体占位尺寸 |
clientWidth |
内边框以内 | 内容、内边距 | 边框、外边距、垂直滚动条宽度 | 读取内部可视区域 |
scrollWidth |
完整可滚动内容 | 内边距、未显示完的内容 | 边框、外边距 | 判断是否横向溢出 |
当内容没有溢出时,scrollWidth 通常等于 clientWidth。出现横向溢出后,scrollWidth 会大于 clientWidth,因此常用 element.scrollWidth > element.clientWidth 判断内容是否被截断。

用同一个元素验证差异
下面的页面创建一个固定盒模型,并放入更宽的子元素。示例输出实际数值,同时验证三组属性之间的关键关系。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>元素尺寸验证</title>
<style>
#box {
/* 固定 content-box,便于分开计算内容、内边距和边框 */
box-sizing: content-box;
width: 200px;
height: 100px;
padding: 20px;
border: 5px solid #1e3a8a;
overflow: auto;
}
#content {
/* 子元素主动超过容器,制造横向和纵向溢出 */
width: 400px;
height: 160px;
background: #dbeafe;
}
</style>
</head>
<body>
<div id="box">
<div id="content">宽度超过容器的内容</div>
</div>
<pre id="result"></pre>
<script>
const box = document.querySelector('#box');
// 输出原始尺寸和关系判断,避免滚动条差异干扰验证
const result = {
offsetWidth: box.offsetWidth,
clientWidth: box.clientWidth,
scrollWidth: box.scrollWidth,
borderIncluded: box.offsetWidth > box.clientWidth,
horizontalOverflow: box.scrollWidth > box.clientWidth,
verticalOverflow: box.scrollHeight > box.clientHeight
};
document.querySelector('#result').textContent =
JSON.stringify(result, null, 2);
</script>
</body>
</html>预期结果
{
"offsetWidth": 250,
"clientWidth": <CLIENT_WIDTH>,
"scrollWidth": <SCROLL_WIDTH>,
"borderIncluded": true,
"horizontalOverflow": true,
"verticalOverflow": true
}offsetWidth 为 250,因为内容宽 200、左右内边距共 40、左右边框共 10。<CLIENT_WIDTH> 会受浏览器滚动条占位方式影响,<SCROLL_WIDTH> 也可能因布局实现出现少量差异,但两个溢出判断应稳定为 true。
关键边界与选择规则
这些属性返回整数布局值,适合做溢出判断、折叠高度计算和组件排版。若需要小数、变换后的视觉尺寸或相对视口的位置,应改用 getBoundingClientRect()。
CSS transform: scale(...) 会改变元素视觉大小,但不会改变 offsetWidth、clientWidth 和 scrollWidth 的布局计算结果。元素或其祖先处于 display: none 时,没有生成布局盒,这些尺寸通常为 0。
scrollWidth 可能受到伪元素和不可见溢出内容影响。排查异常值时,应同时检查 box-sizing、内边距、边框、overflow、子元素宽度以及 ::before、::after。
选择时可使用最短规则:需要元素整体边框盒尺寸时读 offsetWidth;需要内部可视区域时读 clientWidth;需要完整内容范围或判断溢出时读 scrollWidth。高度方向使用同样的判断方法。