弹窗内部滚动失效而页面跟着滚，根本原因是touchmove事件未被拦截且可滚动区域未显式声明；须用.modal__content包裹内容并设overflow-y:auto、-webkit-overflow-scrolling:touch及明确高度。
弹窗内部滚动失效，页面却跟着滚
这是移动端最典型的滚动穿透问题：遮罩层盖住了，但手指一滑，底下的页面还在动。根本原因是 touchmove 事件没被拦截，且弹窗内容容器没正确声明可滚动区域。iOS 的橡皮筋效果会让 overflow: hidden 形同虚设，光靠 CSS 锁 body 是治标不治本。
- 别在遮罩层（
.overlay）或弹窗根节点（.modal）上直接加@touchmove.prevent或event.preventDefault()—— 这会同时禁掉内部内容滚动，iOS 阻尼消失，input聚焦也失灵 - 可滚动区域必须单独包裹一层（比如
.modal__content），并显式设overflow-y: auto+-webkit-overflow-scrolling: touch - 该容器需有明确高度（不能靠
100%撑开），建议用max-height: 70vh或calc(100vh - 120px)，避免撑爆视口 - 确保父级没设
overflow: hidden或transform，否则会剪裁滚动区域
dialog 元素里怎么让内容局部滚动
dialog 自带模态行为，但它的 ::backdrop 不影响内部滚动逻辑。想让弹窗内容可滚、背景不动，关键不在 backdrop，而在 dialog 内部结构。
- 不要把整个
dialog设为overflow: auto—— 这会导致遮罩层也被卷进去，视觉错乱 - 在
dialog内部嵌套一个固定高度的div，例如：<div class="dialog__scroller">...</div>，然后只给它加overflow-y: auto - 必须补
-webkit-overflow-scrolling: touch，否则 iOS 滚动卡顿、无惯性 - 如果用
showModal()打开，无需手动锁 body；但若降级用show()，仍要自己处理scrollTop保存与还原
position: fixed 遮罩层下如何精准控制滚动锚点
用 body.style.position = 'fixed' 锁滚动时，还原位置稍有偏差就会跳顶。这不是 bug，是不同浏览器对 scrollTop 的读取优先级不一致导致的。
anything-to-html
下载
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 读取时必须同时检查
document.documentElement.scrollTop和document.body.scrollTop，取较大值（iOS Safari 常走前者，Chrome 常走后者） - 还原时不能只设
body.style.position = ''，必须清空整个style.cssText，否则残留的top: -xxxpx会干扰后续任何滚动操作 - 还原后调用
window.scrollTo(0, savedTop)，而不是直接赋值document.body.scrollTop—— 后者在部分安卓 WebView 中无效 - 别用
document.scrollingElement，IE 和旧版 Safari 不支持，兼容性风险高
为什么局部遮罩层（非全屏）滚动会失效
当遮罩只盖某个卡片而非全屏时，常见错误是把遮罩层写成 position: fixed。它会脱离文档流，无法跟随父容器滚动，结果就是“遮罩悬空”，下面区域依旧可点可滚。
立即学习“前端免费学习笔记（深入）”；
- 局部遮罩必须用
position: absolute，且其父容器必须有position: relative（或absolute/fixed） - 遮罩尺寸别写
100vw/100vh，应写top: 0; left: 0; right: 0; bottom: 0，否则父容器滚动时遮罩不会重绘 - 如果父容器有
transform、filter或opacity < 1，会创建新的层叠上下文，导致遮罩 z-index 失效——此时要么提级遮罩到body下，要么给父容器加isolation: isolate
滚动穿透的本质不是样式没写对，而是事件流没截住、锚点没记牢、容器没框死。三个地方最容易漏：可滚动容器没加 -webkit-overflow-scrolling、还原 scrollTop 时没清空 style.cssText、局部遮罩用了 fixed 却忘了父级定位。
