滚动发黏、滑动掉帧:非 passive 的事件监听是怎么拖慢渲染的
页面其他部分都正常,只有滚动卡顿,常见原因是 wheel/touchmove 监听没声明 passive,浏览器必须等 JS 跑完才敢滚。本文给出定位手法、写法修正,以及用 CSS 代替 preventDefault 的思路。
页面里挂了 wheel 或 touchmove 监听却没声明 passive,浏览器每帧都要等这段 JS 跑完才敢滚动;主线程一有长任务,滚动手感立刻变成「发黏」。
为什么一个监听器能卡住滚动
触摸和滚轮滚动默认由合成线程(compositor)处理,不依赖主线程,所以能稳定跑满帧率。但只要元素上挂了 touchstart、touchmove 或 wheel 监听,浏览器就无法预知回调里会不会调用 preventDefault 来阻止滚动,只能先把事件同步发给主线程,等回调返回再决定这一帧滚不滚。
于是滚动的流畅度被绑定在主线程的繁忙程度上:主线程在跑一次大数据量渲染、一次同步 XHR、一次长正则,滚动就跟着停顿。这就是「页面其他部分都在动,只有滚动拖泥带水」的典型成因。
怎么确认是这个问题
Chrome DevTools 的 Performance 面板录制一段滚动,看两处:
- Console 里是否出现 Added non-passive event listener to a scroll-blocking event 这类警告,警告会直接点名事件类型和绑定位置。
- 滚动帧中主线程是否出现长任务(红色三角标记),且任务栈落在你的事件回调里。
也可以在 Console 里用 getEventListeners(window) 看 wheel、touchmove 上到底挂了多少个回调。第三方埋点、轮播插件、懒加载库经常在你不知情的情况下往 document 上挂监听,这是加装 analytics 之后滚动变卡的常见原因。
改法:能 passive 就 passive
明确不需要阻止默认行为的监听,第三参直接给 passive:
// 纯统计、视差、吸顶判断这类,一律 passive
window.addEventListener('wheel', onScroll, { passive: true });
window.addEventListener('touchmove', onTouchMove, { passive: true });
// 只在需要时移除,注意第三参要一致,否则移除不掉
window.removeEventListener('wheel', onScroll, { passive: true });
确实需要阻止滚动的场景(自定义下拉、地图画布、横向轮播),优先用 CSS 表达意图,而不是靠 JS 拦事件:
.map-canvas {
touch-action: none; /* 这块区域不参与浏览器手势滚动 */
overscroll-behavior: contain; /* 滚到底不把滚动传给父级 */
}
CSS 声明是静态的,浏览器在合成阶段就知道该区域不滚动,不必把事件同步到主线程做决策——比事件里 preventDefault 便宜得多。
顺带纠正一个常见误解:scroll 事件本身不可取消,加不加 passive 都一样;真正需要关注的是 wheel、touchstart、touchmove、pointerdown 这几个可取消事件。
适用边界与常见坑
- 加了 passive: true 之后,回调里再调 preventDefault 不会生效,控制台只留一条警告。线上环境很容易把这条警告过滤掉,结果功能静默失效。
- 挂在 document 或 window 上的监听影响面最大,能收敛到具体容器就不要挂全局。
- 第三方 SDK 改不了源码时,可以在捕获阶段先包一层,或者直接向供应商要 passive 开关;实在不行就在初始化后再补挂一遍并移除原来的。
- 滚动卡顿不止这一个成因。先排除长任务、频繁的布局抖动(读写交替导致的强制重排)和大图解码,再确认监听器;否则改完 passive 会感觉「没什么变化」。
- passive 治不了移动端的触摸延迟。点击与滑动的延迟还受 viewport 设置和双击缩放影响,要配合 viewport 的 width=device-width 与 touch-action: manipulation 一起调。
正在加载评论…