浏览器与 Web API / 系统课时

getBoundingClientRect 与坐标

getBoundingClientRect 与坐标

本课解决“元素当前出现在视口哪里,以及如何换算为整份文档中的位置”这两个问题。你将读取 DOMRect,区分视口坐标与文档坐标,并用滚动后的结果验证坐标换算公式。

学习目标

  • 读取 getBoundingClientRect() 返回的矩形边界与尺寸
  • 区分视口坐标、文档坐标和事件坐标
  • 使用 scrollX、scrollY 将视口坐标换算为文档坐标

DOMRect 与两套坐标原点

调用 element.getBoundingClientRect() 会返回一个 DOMRect。其中 left、top、right、bottom 描述元素边框盒相对当前视口左上角的位置,width 与 height 描述经过 CSS 变换后的视觉尺寸,结果允许出现小数。

页面滚动时,元素在文档中的位置通常没有变化,但它相对视口的 top 和 left 会变化。元素滚出视口上方后,top 可以是负数;位于视口右侧或下方时,边界值也可以大于视口尺寸。

视口坐标与文档坐标换算

普通文档流元素的文档坐标可以用下面的公式换算:

documentLeft=rect.left+window.scrollXdocumentLeft = rect.left + window.scrollX
documentTop=rect.top+window.scrollYdocumentTop = rect.top + window.scrollY

window.scrollX 与 window.scrollY 表示页面在水平方向和垂直方向已经滚动的距离。现代页面通常也可读取 window.pageXOffset 与 window.pageYOffset,但新代码优先使用前者。

换算并验证文档坐标

下面的页面把目标元素放在较靠下的位置。滚动页面后点击按钮,输出视口坐标、文档坐标和换算关系。

html
<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>DOMRect 坐标验证</title>
  <style>
    body {
      /* 保留足够滚动空间,使视口坐标随滚动而改变 */
      margin: 0;
      min-height: 1800px;
      font-family: sans-serif;
    }
    #target {
      width: 240px;
      padding: 20px;
      border: 4px solid #1e3a8a;
      margin-top: 900px;
      margin-left: 120px;
      /* 0.5px 变换用于观察 DOMRect 可以返回小数 */
      transform: translateX(0.5px);
    }
    #result {
      position: fixed;
      top: 12px;
      right: 12px;
      width: 360px;
      white-space: pre-wrap;
      background: #eff6ff;
      padding: 12px;
    }
  </style>
</head>
<body>
  <div id="target">目标元素</div>
  <button id="measure">读取坐标</button>
  <pre id="result">滚动页面后点击“读取坐标”</pre>
  <script>
    const target = document.querySelector('#target');
    const result = document.querySelector('#result');

    document.querySelector('#measure').addEventListener('click', () => {
      const rect = target.getBoundingClientRect();
      // DOMRect 是视口坐标,加页面滚动量得到文档坐标
      const documentLeft = rect.left + window.scrollX;
      const documentTop = rect.top + window.scrollY;

      result.textContent = JSON.stringify({
        viewport: { left: rect.left, top: rect.top },
        document: { left: documentLeft, top: documentTop },
        scroll: { x: window.scrollX, y: window.scrollY },
        topFormulaValid:
          Math.abs(documentTop - rect.top - window.scrollY) < 0.01
      }, null, 2);
    });
  </script>
</body>
</html>

预期结果

text
{
  "viewport": {
    "left": <VIEWPORT_LEFT>,
    "top": <VIEWPORT_TOP>
  },
  "document": {
    "left": <DOCUMENT_LEFT>,
    "top": <DOCUMENT_TOP>
  },
  "scroll": {
    "x": <SCROLL_X>,
    "y": <SCROLL_Y>
  },
  "topFormulaValid": true
}

实际数值会随窗口大小和滚动距离变化。稳定关系是 <DOCUMENT_TOP> - <VIEWPORT_TOP> = <SCROLL_Y>,并且 topFormulaValid 为 true。

事件坐标与特殊边界

鼠标事件中的 clientX、clientY 以视口左上角为原点,可直接和 DOMRect 比较,例如判断点击点是否位于元素内部。pageX、pageY 以文档左上角为原点,已经包含页面滚动偏移;screenX、screenY 则相对物理屏幕,通常不用于页面布局计算。

判断点击是否落在元素矩形中时,应使用同一坐标系:把 event.clientX 与 rect.left、rect.right 比较,把 event.clientY 与 rect.top、rect.bottom 比较,不要混用 pageX 和 rect.left。

getBoundingClientRect() 反映 CSS 变换后的视觉矩形,因此可能与 offsetWidth 不同。页面缩放、子像素布局和变换会产生小数,比较时不要依赖严格整数相等。

对于 position: fixed 元素,矩形始终相对视口稳定。简单地加上页面滚动值只会得到一个随滚动变化的数,不代表它在普通文档流中的固定位置。若目标位于可滚动容器内,还要区分页面滚动与容器自身的 scrollTop、scrollLeft。

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

目录与阅读设置

阅读设置

17

记录一个想法

getBoundingClientRect 与坐标

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

登录哪都通