浏览器与 Web API / 系统课时
getBoundingClientRect 与坐标
getBoundingClientRect 与坐标
本课解决“元素当前出现在视口哪里,以及如何换算为整份文档中的位置”这两个问题。你将读取 DOMRect,区分视口坐标与文档坐标,并用滚动后的结果验证坐标换算公式。
学习目标
- 读取
getBoundingClientRect()返回的矩形边界与尺寸 - 区分视口坐标、文档坐标和事件坐标
- 使用
scrollX、scrollY将视口坐标换算为文档坐标
DOMRect 与两套坐标原点
调用 element.getBoundingClientRect() 会返回一个 DOMRect。其中 left、top、right、bottom 描述元素边框盒相对当前视口左上角的位置,width 与 height 描述经过 CSS 变换后的视觉尺寸,结果允许出现小数。
页面滚动时,元素在文档中的位置通常没有变化,但它相对视口的 top 和 left 会变化。元素滚出视口上方后,top 可以是负数;位于视口右侧或下方时,边界值也可以大于视口尺寸。

普通文档流元素的文档坐标可以用下面的公式换算:
window.scrollX 与 window.scrollY 表示页面在水平方向和垂直方向已经滚动的距离。现代页面通常也可读取 window.pageXOffset 与 window.pageYOffset,但新代码优先使用前者。
换算并验证文档坐标
下面的页面把目标元素放在较靠下的位置。滚动页面后点击按钮,输出视口坐标、文档坐标和换算关系。
<!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>预期结果
{
"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。