Files
lsky-pro-docker/test
mole404 30862d602f feat(图片页 1/2): 详细信息与移动到相册改用居中卡片弹窗、二级菜单返回键加空隙
#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 等。
2026-09-29 14:34:25 +08:00
..

补丁行为测试(node + jsdom)

没有 iPhone 也能先把补丁的每条分支跑一遍:用真实的 DOM + jQuery 事件复刻 resources/views/user/images.blade.php 的用法,验证

  1. iOS 长按:只在 iOS 生效、其它平台长按相关代码一行都不执行;
  2. 菜单收放:点菜单之外只关菜单、不点穿到页面(点别的图片不再顺手开预览),滚动/缩放/Esc 关闭;
  3. 看得见就不许点穿:菜单还画在屏幕上的任何时刻(含刚打开、含刚关掉还在淡出的 100ms、含状态被别的路径 提前置 false 但元素还在)点击都不许直通页面;
  4. 触摸端二级菜单:点击展开/收起,不再"闪一下就整个菜单消失";有鼠标的设备继续走 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 在真机上的实际取值,这些属于浏览器行为,必须真机验证(本测试只能证明代码路径与事件处理逻辑正确)