滚动穿透本质是浏览器滚动链(Scroll Chaining)机制:弹窗滚至边界后,剩余滑动量传递给body;iOS橡皮筋效果加剧该问题。需从滚动源头、容器层级、渲染机制协同解决——记录scrollTop并用position:fixed+top偏移锁body、禁用transform干扰z-index、合理使用page-meta及边界条件preventDefault,确保无闪屏、不跳顶、不失惯性。

移动端 H5 弹窗背景滚动穿透,本质不是“弹窗没盖住”,而是浏览器滚动链(Scroll Chaining)在起作用:当弹窗内容滚到顶/底,继续拖动会把剩余滑动量传给 body。iOS Safari 的弹性滚动(橡皮筋效果)会让这个问题更明显。要彻底解决,不能只拦事件,得从滚动源头、容器层级、渲染机制三方面协同处理。
锁住 body 滚动,但不闪屏、不跳顶
单纯 body { overflow: hidden } 在 iOS 上无效;只加 position: fixed 会导致页面瞬间回滚到顶部。正确做法是:
- 弹窗打开时,记录当前
document.scrollingElement.scrollTop - 给
body添加类(如modal-open),并设置:body.modal-open { position: fixed; width: 100%; top: -scrollTop + 'px'; } - 关闭弹窗时,先移除类,再把
scrollTop设回去
这个方案兼容所有主流 iOS/Android 浏览器,且不依赖第三方库,实测无闪烁、无延迟。
每层遮罩必须独立拦截点击,禁用 transform 干扰
多层弹窗(比如 A 弹窗里点开 B)容易穿透,根本原因不是事件没 stop,而是 z-index 堆叠上下文被父容器的 transform 或 opacity 破坏。结果就是遮罩视觉上在上层,实际事件流仍能穿过。
- 所有弹窗遮罩层(mask)必须用
position: fixed或absolute,且显式设z-index - 检查父容器是否含
transform、will-change、opacity: 0.99—— 有就去掉,或用transform: translateZ(0)强制提升层级 - 每个遮罩都要绑定
@tap.stop(uni-app)或@touchstart.prevent(Vue),不能只靠最外层统一拦截
用 page-meta 控制页面级滚动行为(uni-app 专属稳解)
uni-app 的 是 H5 端最可靠的兜底手段,它直接作用于页面根节点,绕过 CSS 渲染层限制:
- 在根组件 template 中添加:
-
popupStack是一个响应式数组,每次打开弹窗 push 标识,关闭时 pop - 注意:
全局只能有一个,不要在子组件里重复声明
该方案不影响弹窗内部 滚动,只禁用 body 级滚动,比 JS 操作 class 更干净、更稳定。
弹窗内部滚动需防边界穿透,不靠 preventDefault 硬拦
如果弹窗内容本身可滚动(比如长列表),用户滑到顶部/底部再猛拖,仍可能触发底层滚动。此时不能只靠 touchmove.preventDefault() —— 它在部分安卓机型上有兼容问题,且会禁用整个手势体验。
- 监听弹窗容器的
touchstart和touchmove,计算当前scrollTop、scrollHeight和clientHeight - 仅当滚动已到顶(
scrollTop === 0)且手指向下拖、或已到底(scrollTop + clientHeight >= scrollHeight)且手指向上拖时,才调用e.preventDefault() - 其他情况允许原生滚动,保障顺滑感和惯性回弹











