① 头像在圆形容器里偏左:按钮 h-10 pl-1 pr-2 左右留白不对称(左 4px / 右 8px),
且 <640px 用户名隐藏后只剩纯圆钮 → 改成 h-10 w-10 p-0 justify-center,
≥640px 用 sm:w-auto sm:pl-1 sm:pr-2 保持桌面胶囊形态不变。
实测:手机 390px 下头像左右留白各 6.0px,偏差 0.0px(原 4/8)。
② 二级菜单重合 + 误触:真机触摸带粘滞 :hover,手指一按「复制链接」二级菜单就先弹出来
(旧版还因侧向定位被 clamp 成压在主菜单上),抬手那发合成 click 直接落在菜单项上,
实测被判成「Url」并立刻复制。改为:
- 手机不再侧开二级菜单,改成**就地替换**(面板原地换成 Url/HTML/BBCode… + 顶部「返回」);
- touchstart 即切换并「武装」防误触:判据是**同一根手指那一发**(不是时长),
按多久(实测按住 700ms)抬手都不会误触;
- 守卫顺序:父项处理 → 守卫 → 「返回」;桌面仍保留右侧二级菜单 + 视口钳制。
真触摸(CDP Input.dispatchTouchEvent + CSS.forcePseudoState 模拟粘滞 hover)复现:
改前二级菜单被挤出屏幕外 116px、改后抬手触发动作 = [](什么都没发生)。
③ 手机浏览器地址栏不会自动收起:body 有 overflow-hidden + 内容区是 absolute + overflow-y-auto
的自滚容器,不是根滚动,浏览器只认根滚动。改成 body 去掉 overflow-hidden、容器回正常流
(pt-14 pb-14 补顶栏高度)。fixed 侧栏/顶栏不受影响,全仓无 JS 依赖该内部滚动容器。
④ 策略卡桌面端限高 18rem + 卡内滚动(md: 前缀,手机仍是一列全展开、不滚不截断)。
⑤ 小字号统一抬一档(11/11.5→12.5、12.5/13→13.5、13.5→14,14 以上不动),
受影响页遗留的 text-xs 一并抬到 13.5。
补丁行为测试(node + jsdom)
没有 iPhone 也能先把补丁的每条分支跑一遍:用真实的 DOM + jQuery 事件复刻
resources/views/user/images.blade.php 的用法,验证
- iOS 长按:只在 iOS 生效、其它平台长按相关代码一行都不执行;
- 菜单收放:点菜单之外只关菜单、不点穿到页面(点别的图片不再顺手开预览),滚动/缩放/Esc 关闭;
- 看得见就不许点穿:菜单还画在屏幕上的任何时刻(含刚打开、含刚关掉还在淡出的 100ms、含状态被别的路径 提前置 false 但元素还在)点击都不许直通页面;
- 触摸端二级菜单:点击展开/收起,不再"闪一下就整个菜单消失";有鼠标的设备继续走 hover。
运行
cd test
npm install
npm test # 测 ../src/public/js/context-js/context-js.js
node longpress.test.mjs /path/to/other/context-js.js # 测指定的文件(例如未打补丁的原版)
node repro-clickthrough.mjs /path/to/context-js.js # 最小复现:滚动关菜单后紧接着点图片,会不会点穿
repro-clickthrough.mjs 是老师报的那个"偶尔点穿"的最小复现:它把"菜单插入引发的那一发滚动 →
关菜单 → 紧接着点别的图片"这条时序压成确定性的三步。对着旧版跑会打印 ❌ 点穿了、对着新版跑打印 ✅。
覆盖到的用例
- iPhone Safari(长按):长按 ≥250ms 弹出图床自己的菜单;内容包含"图片操作/复制链接";
beforeOpen/afterOpen回调照旧被调用并拿到元素与菜单节点;菜单用触摸坐标定位;注入-webkit-touch-callout抑制样式;抬手补发的click被吞掉(不会误开图片预览);且那一发 click 不会把刚打开的菜单关掉(回归:菜单"刚开就自己关"的陷阱) - iPhone Safari(菜单收放):菜单开着时点别的图片 → 只关菜单、不开预览;菜单关掉后正常点击照旧生效(不会一直吞点击)
- iPhone Safari(二级菜单):长按菜单后点"复制链接" → 二级菜单展开、整个菜单不关闭、父项默认行为被阻止、没有点穿到页面;再点一次收起(菜单仍开着);点二级菜单里的叶子项(模拟 ClipboardJS 的
.copy)→ 复制逻辑照旧执行、菜单关闭;注入了与 hover 等价的触摸展开样式 - 取消条件:手指移动 >10px(滚动/框选)、多指触摸、短按(<250ms 抬手)都不触发菜单;按住 160ms 抬手不出现、320ms 抬手出现(钉住 250ms 这个分界线)
- 菜单收放(Windows):点图片(菜单外)→ 菜单关闭 + 页面收不到这发 click(预览没开)+ 没有冒泡到 document;菜单内部项点击照旧执行并关闭菜单;页面滚动 / 窗口缩放 / Esc / 内部滚动容器(
#images-scroll)滚动都关菜单;菜单自身滚动不误关 - 有鼠标的设备:即使 UA 是 Windows,只要
matchMedia('(hover: none)')为假,点"复制链接"就不会展开(继续 hover),保持"点菜单项即关闭"的老行为 - iPad 请求桌面网站(UA 伪装成 Mac、
maxTouchPoints=5):仍走长按分支 - Mac(含苹果 M 系列)(
MacIntel但maxTouchPoints=0):不触发长按,右键contextmenu照旧 - Android Chrome:长按不触发新分支、不注入 iOS 样式,
contextmenu照旧打开菜单且阻止浏览器默认菜单;长按抬手补发的 click 不会关掉刚打开的菜单;真手指点别处 → 只关菜单、不开预览 - Windows 桌面:只有右键路径,连续右键仍能开菜单(去重窗口不误伤)
- 回归:看得见的菜单必须拦得住(老师报的偶发点穿):A) 被滚动关掉后元素还在淡出时点别的图片 → 不点穿、不开预览;B) 状态已 false、淡出窗也过了,但 DOM 实测菜单仍可见(把高度桩成 120,因为 jsdom 高度恒为 0)→ 点击照样被吞;C) 菜单刚打开 300ms 内的滚动(它自己引发的)不关菜单、过了 300ms 用户滚动照旧关;D) 菜单彻底消失后点击恢复正常(不会一直吞点击);E)
context.debugDump()含打开记录与关闭原因
已知局限
- jsdom 没有
matchMedia,代码里有能力检测兜底(没有matchMedia时退回'ontouchstart' in window);测试里"有鼠标的设备"那条是显式 stub 出来的 - jsdom 没有排版引擎(元素高度恒为 0,
fadeIn/fadeOut也不产生可见的 opacity/display 变化),所以只校验菜单的left与数值型top;菜单开合状态用补丁新增的context.isMenuOpen()观测 menuOnScreen()的 DOM 实测那条分支(getBoundingClientRect().height > 0)在 jsdom 里恒为假,只能靠桩高度来测(见回归用例 B);它真正的价值在真浏览器里 —— 那是"菜单还看得见就拦得住"的最后一道保险- 同理:真机上"哪一发浏览器行为把状态提前置 false"(滚动锚定 / 懒加载重排 / 平台差异)无法在 jsdom 里完全复刻,所以补丁新增了
context.debugDump()常驻诊断转储:真机再遇到时导出即可定位 - 原生 callout 是否真的被压掉、
touchend的preventDefault是否真的省掉了原生 click、matchMedia在真机上的实际取值,这些属于浏览器行为,必须真机验证(本测试只能证明代码路径与事件处理逻辑正确)