浏览器与 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 判断内容是否被截断。

offset、client 与 scroll 的测量范围

用同一个元素验证差异

下面的页面创建一个固定盒模型,并放入更宽的子元素。示例输出实际数值,同时验证三组属性之间的关键关系。

html
<!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>

预期结果

text
{
  "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。高度方向使用同样的判断方法。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

offset、client 与 scroll 尺寸

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通