页面滚动后热点整体偏移，怎样核对 clientX 与 getBoundingClientRect

clientX/clientY 与 getBoundingClientRect 都相对于视口，可以直接相减。pageX/pageY 带文档滚动量，不能直接减视口矩形；如果需要内容区位置，还要明确是否扣除边框和内边距。

先决定坐标要落在哪个盒子里

夹具在文档下方放一个有10像素边框的区域，分别滚动500和700像素，再点击距边框上沿50像素的位置。期望边框盒局部Y都是50，内容边缘局部Y是40。这里刻意保留边框，就是为了让“相减得到局部坐标”这句话不掩盖实际采用的盒模型。内边距存在时还需按项目定义继续扣除。

只组合处于同一参考系的数据

两次滚动后clientY和rectTop都会变化，二者差值保持相同；pageY则跟随文档位置。如果误把pageY减rectTop，就会把滚动偏移多算一次。调试时把滚动量、矩形上沿和两类事件坐标同一时刻写进日志，不能先缓存矩形，页面后来滚动或布局变化了还拿旧值计算。

附件怎样形成实际证据

程序通过浏览器真实鼠标点击获取事件，不把一张手写坐标表当现场结果。断言同一边框局部点在两次滚动中保持一致，同时核对内容区扣除边框后的值。这个例子没有CSS旋转、缩放和透视；含这些变换的元素不能仅凭一个轴对齐矩形反推出任意局部点，应另定变换处理方案。

失败时沿DOM链继续排查

若日志中差值正确但热点仍错位，检查热点是否使用了另一层容器的坐标，或是否把CSS像素再次乘了设备像素比。不要直接要求现场把系统缩放都改成100%作为网页算法的补救。本题只验网页滚动参考系，和触摸屏映射到哪块显示器、TUIO归一化坐标与四角标定属于不同层级，应分别取证。

把现场日志中的计算式保留下来

记录可直接列出clientY减rectTop得到边框盒局部Y，再减clientTop得到边框以内位置；clientTop比硬写10更适合读取实际边框厚度。若目标是滚动内容内部坐标，还需要加容器自身scrollTop，这与文档scrollY不是同一项。附件没有内层滚动，因此不能把文档示例原样套给嵌套列表；先画出各自滚动容器，再确定要表达的局部坐标。

下载并复现

下载原创HTML夹具、独立验证程序、本次执行记录和依赖与运行说明，放在同一目录。安装Playwright 1.58.0及其Chromium后运行 python verify.py；程序使用两个随机本地端口，自动关闭浏览器与服务，不请求外网或业务接口。

本次实际环境为Python 3.12.4、Playwright 1.58.0、Chromium 145.0.7632.6。Playwright浏览器鼠标/键盘与页面API实跑；无实体硬件或业务控制。断言已通过；完整事件和数值保留在执行记录，不能把它改名后当目标展项测量。

继续核查与一级出处

基础背景见触摸查询机无响应/漂移排查。视口CSS坐标与高DPR位图像素需要保留明确边界，可继续用Canvas 在高分屏上发虚，怎样核对 CSS 尺寸与绘图缓冲尺寸取证；相关工程入口在专题与产品对接说明。

• MouseEvent视口坐标与元素边框矩形：2026-10-24已联网读取一级来源；CSSOM View，2025-09-16 Working Draft；只作机制说明。