ios局部滚动无弹性不是bug而是webkit限制,仅body/html支持bounce;需删-webkit-overflow-scrolling: touch、设明确高度、加passive监听、锁三层防回弹。

为什么 iOS 局部滚动没弹性,不是 bug 是限制
iOS Safari 从不给非根容器(比如 div、scroll-view)提供弹性滚动(bounce)效果。这不是 CSS 漏了属性,也不是 JS 没监听对事件,而是 WebKit 明确禁止——只有 body 或 html 这一级滚动上下文才被赋予 bounce 权限。试图用 overscroll-behavior: contain 或 overscroll-contain 类名“启用”它,只会白忙一场;它们只管是否传递滚动链,和 bounce 完全无关。
局部滚动卡顿/无惯性?先删掉 -webkit-overflow-scrolling: touch
这个属性在 iOS 15.4+/Safari 16+ 中已被浏览器主动忽略或降级,加了反而触发旧滚动线程,导致 fixed 错位、惯性丢失、掉帧更严重。检查所有 CSS 文件和 JS 动态注入逻辑(尤其某些 UI 库初始化时偷偷加),只要存在就删。
- 滚动容器必须设明确高度:用
height: 100dvh(别用100vh,地址栏展开会塌缩)或max-height - Flex 布局中,父容器需加
min-height: 0,否则子项 height 计算失效 - 加
will-change: scroll-position提示 iOS 创建合成层(仅对 iOS 15+ 有效) - 移除干扰合成层的祖先样式:
filter、opacity: 0.99、backdrop-filter、mask
touchmove/scroll 事件不设 { passive: true } 就等于卡顿开关
iOS Safari 遇到未声明 passive 的 touchmove 或 scroll 监听器,会强制暂停滚动等待 JS 回调返回,帧率可能从 60fps 直接掉到 20fps。
- 错误写法:
el.addEventListener('touchmove', handler) - 正确写法:
el.addEventListener('touchmove', handler, { passive: true }) - 同理适用于
scroll:el.addEventListener('scroll', handler, { passive: true }) - 真需要阻止默认行为(如拖拽排序)?改用
touchstart+e.preventDefault(),别在scroll里调
H5 禁用 body 弹性回弹,得锁三层:容器、滚动区、事件流
所谓“滑到底部回弹”,本质是 touchmove 没被及时拦截,且 body 仍可滚动。单靠 CSS 或单靠 JS 都会漏掉一环。
-
html和body必须设overflow: hidden(CSS + JS 双保险更稳) - 滚动容器(如
scroll-view)要固定高度(height: 100dvh)、overflow-y: auto,不能靠 flex 自动撑高 - 在
mounted或页面加载后立即绑定:document.addEventListener('touchmove', e => e.preventDefault(), { passive: false }) - 注意:如果页面有 fixed 导航栏或 TabBar,得确保它们不被
overflow: hidden裁剪(用position: fixed+z-index) - 真机调试前务必关掉 HBuilderX 的「调试基础库」——它会在 iOS H5 注入干扰性 touch 监听器
最容易被忽略的是:回弹是否出现,取决于滚动内容是否真正超出容器高度。哪怕只差 1px,iOS 就判定为“不可滚动”,把 touch 交给 body 处理。用 getBoundingClientRect() 或真机调试器查实际高度,比肉眼判断可靠得多。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











