标签下拉撑破窗口 —— portal 浮层拿了未缩放的 CSS 像素¶
症状¶
Tony 实测 v0.10.205(80% 缩放):点开「同步标签」下拉, 浮层撑满整个窗口、盖住左侧导航,而里面只有 1 个标签。
根因:我自己在 v0.10.200 引入的回归¶
tags-popper-new.tsx:170 一直这样定浮层宽度:
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 像素、什么时候该用视觉尺寸」——
下一个人不必再撞一次才知道。