CSS如何实现移动端列表的平滑滚动_利用scroll-behavior属性

作者：袖梨 2026-07-25

移动端列表平滑滚动需将 scroll-behavior: smooth 显式加在可滚动容器上，而非 html；iOS Safari 15.4 前不支持，JS 调用 scrollIntoView({ behavior: 'smooth' }) 最可靠，但需确保容器渲染完成、目标存在，并配合降级方案与性能优化。

移动端列表平滑滚动不能只靠 scroll-behavior: smooth 写在 html 上——它对自定义滚动容器（比如带 overflow-y: auto 的列表）才真正起作用，且 iOS Safari 15.4 之前完全不支持，16+ 也仅限 JS 主动调用生效。

为什么给 `html` 加 `scroll-behavior: smooth` 对列表无效

因为 scroll-behavior 只作用于「实际发生滚动的容器」。整页滚动容器是 html，但列表滚动发生在某个 div 内部，它的滚动上下文和 html 是隔离的。

必须把 scroll-behavior: smooth 显式加到那个可滚动的列表容器上，例如：.list-container { overflow-y: auto; scroll-behavior: smooth; }
如果容器用了 overflow: hidden 或没设高度/溢出，scroll-behavior 直接被忽略
某些 UI 框架（如 Ionic、Vant）会包裹一层 transform 容器，导致目标元素脱离标准滚动流，此时即使样式写了也不触发平滑

`scrollIntoView({ behavior: 'smooth' })` 在列表里怎么用才不翻车

这是目前最可靠的方式，但时机和目标必须精准，否则滚动位置错乱或根本不动。

确保调用时列表容器已渲染完成，避免 offsetTop 为 0：用 requestAnimationFrame 包一层再执行
不要直接对 window 或 document.scrollingElement 调用，而是对列表容器内的目标元素调用：targetEl.scrollIntoView({ behavior: 'smooth', block: 'nearest' })
iOS Safari 15.4 以下会静默降级为瞬时滚动，需提前检测：typeof Element.prototype.scrollIntoView === 'function' && 'behavior' in ScrollIntoViewOptions.prototype
若列表使用虚拟滚动（如 react-window），目标元素可能尚未挂载，得配合 ref 和 onItemsRendered 回调触发

安卓 WebView 和微信 X5 内核的兼容性陷阱

它们常把 behavior: 'smooth' 当作非法参数忽略，不报错，但滚动变成硬跳。

立即学习“前端免费学习笔记（深入）”；

别依赖 'scrollBehavior' in document.documentElement.style 做判断——这只能测 CSS 属性，不能反映 JS API 支持度
真实检测方式：创建一个临时元素，调用 el.scrollIntoView({ behavior: 'smooth' })，监听 scroll 事件是否在 100ms 内连续触发（平滑滚动会发多次）
微信内嵌页默认禁用平滑滚动，需在 WebView 初始化时显式开启（如 Android 端配 webSettings.setSmoothScrollingEnabled(true)）
降级方案建议用 scrollTo + requestAnimationFrame 实现简易缓动，比引入 full polyfill 更轻量