# 可逆滚动与上滑回退 · 1.12.0 用户要求把“下滑触发,上滑收回”加入本机实验室。入口 `/scroll-response/index.html`,六个图文示例在同一长页;每个内部阅读区都能切换三个模式。`/scroll-response/page.html` 则直接跟随整页滚动。主实验室注册 `response-*` 六项,142 项、23 分类。三种行为是同一底座的配置,不把六乘三当作十八个独立算法。 ## 运行方式与用途 | 模式 | 用户能观察到的结果 | 实际机制 | |---|---|---| | once / 播放一次 | 第一次下滑显现,回滑仍保持完整内容 | 越过开始位置自动播放,完成状态保留;快速跳过直接完成 | | repeat / 反复触发 | 越过触发线播放,上滑退回这条线时反向收回;能再次播放 | 作用域逐帧正反推进同一条暂停的 WAAPI 时间线;中途回滑沿当前帧回退 | | scrub / 跟随滚动可逆 | 滑多少变化多少,停下定格,回滑倒回 | 未变形外层的真实坐标转成 0—1,设置动画 currentTime;与播放时长无关 | 这是一种滚动回退机制,不是滚到网页边缘的浏览器橡皮筋回弹,也不使用物理弹簧模拟。反复触发不会仅因图片从视口上方离开就隐藏;要上滑退回开始位置才收回。切换模式会依据当前位置重建时间线,重置会回到该滚动容器的顶部。 | 示例 | 解决的问题与适用位置 | 实现/素材来源 | |---|---|---| | response-fade 柔和显现与收回 | 图文模块进退,保持阅读节奏;章节与图文说明 | 原创 opacity/translate 关键帧;继承 reading/images/collection.webp | | response-mask 图片遮罩开合 | 比较图片展开和收回;摄影入场 | 原创 inset clip-path;继承 studio.webp | | response-zoom 图片缩放往返 | 沿相同镜头路径靠近/返回;材质展示 | 原创 scale 关键帧;继承 materials.webp | | response-lines 文字逐行回退 | 标题逐行进退;章节短句 | 原创三个逻辑行、遮罩和错峰关键帧;系统字体 | | response-shape 圆形展开与收拢 | 小取景展开完整画面;品牌摄影 | 原创圆角 inset 开合;继承 details.webp | | response-parallax 视差正反移动 | 图片沿阅读方向移动,回滑同路返回 | 原创 translate/scale;继承 collection.webp | 图片沿用本机 1.5.0 的 imagegen 女装概念素材,来源历史见 `reading/GALLERY.md`,不作为真实工厂或实物证据;本轮未生成新图片或下载外部摄影。底座、界面、模式控制和注册适配为本轮原创。`case-runtime.js` 作用域及已有主预览挂载/暂停/减少动态/销毁接口为继承;旧 `mountScrollReveal` 保留原一次播放规则,不自动改动旧网站。 ## 可复用接口 HTML 在未运行脚本时保持可见。外层 `data-response-anchor` 用于测量;仅其内部 `data-response-target` 变形/裁切,避免测量坐标被动画本身改变。`data-response-style` 选择 fade/mask/zoom/lines/shape/parallax。多目标如文字逻辑行可共用一个未变形外层。 ```js import {mountScrollResponse} from './framework/scroll-response.js'; const response = mountScrollResponse({ root: document.querySelector('main'), scrollRoot: window, // 也可传入固定高度、overflow:auto 的容器 mode: 'scrub', start: .82, end: .28, duration: 1050, intensity: .6 }); response.setMode('repeat'); response.pause(); response.play(); response.reset(); response.updateOptions({reducedMotion: true, speed: .8}); response.getState(); // 当前模式、方向及每个目标的测量/实际进度 response.destroy(); ``` `start` / `end` 为视口高度比例:外层顶部从 82% 移到 28% 时,scrub 从 0 变到 1;参数必须满足 `0 <= end < start <= 1`。预览为了在较小容器内看清正反变化,改用 28%→4%;整页体验与默认接口保持 82%→28%。不拦截滚轮、不锁定滚动,不使用平滑滚动库。界面定位按钮只是改变真实滚动位置,随后同一测量逻辑更新动画,没有另一套假动画。 暂停冻结实际动画,用户仍可正常滚动;继续时按当前位置更新。速度仅影响 once/repeat 的自动时间线,scrub 的最终位置由滚动决定。减少动态直接显示完整终态,模式和滚动仍可使用;关闭系统减少动态后恢复正常行为。包含键盘焦点的目标保持完整显示,卸载取消动画,恢复默认可见 DOM,并清理事件、观察器、RAF 和订阅。 ## 工作流、证据与范围 执行者为 Codex 单一执行者,没有代理协作或独立审美评审。输入为用户对可逆滚动的描述与“放进实验室”授权。读取已有 reading-motion、reading-renderer、case-runtime、注册表、源码打包脚本及图片来源,决定单独增加共享机制,保留已有一次显现代码。 技术核对使用 [MDN Animation.reverse](https://developer.mozilla.org/en-US/docs/Web/API/Animation/reverse) 和 [MDN Animation.currentTime](https://developer.mozilla.org/en-US/docs/Web/API/Animation/currentTime),只核对原生 API 行为;实际代码原创,不复制网页示例。 Node 22.20.0 语法/规格检查;Playwright 1.62.1 驱动 Edge 155.0.4283.45,在真实本机 23340 页面验证六项的三模式、下滑/上滑、中间帧、暂停继续、再触发、一次状态保留、整页绑定、模式/系统开关、主预览、销毁和布局。手机为 Edge 触摸模拟,尚未在实体手机验证。 一次读取不存在的 reading/page.js,随后依据本轮实际入口创建独立页面,不改旧页面脚本。初次机制检查通过,但真实截图显示预览触发点太低,文字和反向过程容易滑出容器;调整预览触发比例、主预览图片与字区尺寸后重新完整检查。截图存在与实际查看分别记录,不把首轮画面当作最新版本验收。 本轮源码和静态页面仅在本机更新,未上传到用户服务器,未改女装生产网站或 Skill。 ## 完成记录与实际失败修正 六项 × 三种模式完整检查通过;真实鼠标下滑/上滑、键盘 PageDown、触摸模拟正反手势、一次状态保留、反复收回及再触发、scrub 中间定格/倒回、暂停继续、手动/系统减少动态及恢复、六项主预览、整页绑定、焦点完整显示、重置和销毁均通过。320/390/768/1440 无页面横向溢出;主预览手机宽度的操作区在可见区域内。页面脚本异常为空。原 tests/reading.cjs 回归通过。 调低预览触发线后,首个触摸用例的滑动距离不足以越线,改为明确的较长分段手势并增加实际向上滑回检查。真实截图还发现原生负播放速率的 clip-path 在反向期间会显示空底,虽然计算样式和时间正确;暂停才恢复图片。最终采用 scope 帧时钟推进暂停动画的 currentTime,不再依赖负播放速率合成。完整检查重新通过,反向中间图片截取包含 76,234 种像素颜色,实际查看 reverse-fixed-page.png 确认可见;失败诊断图保留为过程证据,不算最新验收。 主要证据:evidence/scroll-response/results.json、reverse-visible-crop.png、reverse-fixed-page.png、各示例起中止/收回截图、手机与整页截图。已实际查看最新六项画面及主预览/手机/整页画面。测试使用 Edge 浏览器及触摸模拟,没有实体手机性能结论。源码包和本机下载检查结果保存在打包后生成的 evidence/scroll-response/release.json,该文件不纳入自身 ZIP 摘要。