跳转至

标签下拉撑破窗口 —— portal 浮层拿了未缩放的 CSS 像素

症状

Tony 实测 v0.10.205(80% 缩放):点开「同步标签」下拉, 浮层撑满整个窗口、盖住左侧导航,而里面只有 1 个标签。

根因:我自己在 v0.10.200 引入的回归

tags-popper-new.tsx:170 一直这样定浮层宽度:

const width = anchorEl?.clientWidth;

clientWidth 返回的是布局用的 CSS 像素,不含 zoom。

  • v0.10.200 之前:zoom 挂在 body 上 ⇒ Popper(portal 到 body)也被缩 ⇒ CSS 像素给 CSS 像素,两边同一套坐标,正好抵消
  • v0.10.200 之后:zoom 下移到 #root(为修浮层定位)⇒ Popper 落在缩放子树外面、不被缩 ⇒ 80% 下锚点视觉宽 1600px,clientWidth 却给出 2000px, 浮层按 2000 渲染且不缩 ⇒ 比锚点宽 25%,撑出窗口

⇒ 那次修法解决了定位,却打破了一个没人写下来的平衡: 「锚点与浮层同处一个坐标系」。

修复

新增 src/utils/visual-size.ts 作为单一源:getBoundingClientRect().width 返回实际渲染矩形,天然是视觉尺寸 —— 两个世界之间的换算它已经做完了。

全仓 5 处用 clientWidth/offsetWidth 的,按「值交给谁」分成两类:

文件 值给谁 处置
tags-popper-new.tsx Popper(portal) ✅ 改 visualWidth
country-select.tsx CustomPopover(portal) ✅ 改 visualWidth
locations-select.tsx CustomPopover(portal) ✅ 改 visualWidth
tags-textfield-new.tsx 输入框内的 Chip 容器(子树内) ⛔ 不动 —— 两边同被缩,CSS 像素才对
data-table.tsx 表格自身(子树内) ⛔ 不动

判据

tests/portal-visual-size.test.ts 是双向的:

  • 点名清单里的文件不许出现 clientWidth/offsetWidth
  • 反向:子树内那两个不许被「顺手统一」成 visualWidth —— 换了反而算大一截

变异 M33(退回 clientWidth)/ M34(visualWidth 内部改用 offsetWidth)/ M35(把子树内的也统一掉)三发全中。

后续(v0.10.207):这条 issue 的判据自己也太窄

本文立的闸写成「portal 浮层一律用 visualWidth」。 Tony 随后要求标签下拉跟着显示比例缩放 —— 改完闸当场红,而那个改动是对的。

真正的不变量不是「用哪个 API」,是「浮层的坐标系与它拿到的尺寸必须配套」:

方案 浮层缩放 尺寸该用
A 不缩 视觉尺寸
B 内容加 zoom CSS 像素

详见 0168-clear-buttons-did-not-say-local-only 第四节。

元教训

这是同一条缩放线上的第四次返工,前三次分别是: 改错目标(body.minHeight)、改错层面(disablePortal)、改对了但打破别处(本次)。

共同点:每次都只盯着"我要修的那个症状",没问"这一改,还有谁跟它共享着某个前提"。 这次共享的前提是「锚点与浮层同处一个坐标系」—— 它从来没被写下来过,所以改的时候也没人想起它。

⇒ 沉淀:visual-size.ts 的头注把这个前提写死了, 并且说清「什么时候该用 CSS 像素、什么时候该用视觉尺寸」—— 下一个人不必再撞一次才知道。