#1 「详细信息」「移动到相册」弃用右侧抽屉,改复用 x-modal 的居中卡片弹窗(新增 #image-detail-modal / #image-movements-modal 及其内容容器,三个新模板): - 详细信息:顶部小缩略图 + dl 行式布局(<640px 自动上下堆叠),标签 13px / 值 14px / leading-6;字段顺序按老师要求 = 上传时间 → 图片名称 → 其余 10 项(原抽屉里 12 项一个没删, 只换位置);弹窗内不放复制链接/下载/删除(单一职责)。 - 移动到相册:单选列表(当前所在相册带「当前」徽标)、行 min-h-[44px](手机点击区)、 未选中时「移动」disabled;请求逐字沿用原实现(同 route user.images.movement、同 payload); 点「移动」才提交,成功关弹窗 + resetImages + toastr。 - 右侧抽屉保留本职(工具栏「相册列表」入口、自带无限加载、相册增删改查)原样不动; 桌面右键、手机长按、工具栏三个入口都走新弹窗。 #2 二级菜单「<返回」箭头与文字间距:context-js.less 加 7px(选择器权重压过标记自带 mr-1)。 关键:本轮的 images.blade.php 改动不属于补丁文件(context-js.js 两份 md5 全程 = Dockerfile 钉住的 b916555a…,未动),Dockerfile 的 images_blade_md5 已随自证同步更新为 27bb3f20…,补丁重生成 2563 行 且「打回上游 = 仓库文件」字节一致。 验证:四套回归我自己跑过 —— longpress 79/79、sidebar 6/6、images-modal 35/35(静态契约: 12 字段与顺序 / 13-14px 字号 / min-h-44 / 请求不变 / 无硬编码色 / 返回键 7px / 补丁 md5 未变)、 images-modal-dom 35/35(jsdom 真跑页面内联脚本:点菜单 → 内容进新弹窗、抽屉全程为空且未被推开、 单选互斥、点「移动」实发 {selected,id,album_id} 后关弹窗、抽屉路径仍能筛选相册); php -l + view:cache exit 0;重建产物含 text-[13px]/[14px]/min-h-[44px]/max-h-[50vh]/ls-badge 等。
补丁行为测试(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在真机上的实际取值,这些属于浏览器行为,必须真机验证(本测试只能证明代码路径与事件处理逻辑正确)