safari 中 scroll-behavior: smooth 默认不生效,应改用 scrollintoview({ behavior: 'smooth' }) 并配合 hashchange 事件监听与元素存在性校验,ios 15.4/macos 12.3 起已原生支持且行为一致。

scroll-behavior: smooth 在 Safari 中默认不生效
直接在 html 或 body 上设 scroll-behavior: smooth,Safari(包括最新版 macOS 和 iOS)仍会执行跳转式滚动,不是平滑的。这不是你写错了,是 Safari 对该 CSS 属性的支持长期停留在「部分实现」状态——它识别该声明但不触发实际动画。
用 JavaScript 的 scrollIntoView 替代 CSS 声明
这是目前最可靠、兼容性最好的方案。Safari 自 iOS 15.4 / macOS 12.3 起已完整支持 scrollIntoView 的 { behavior: 'smooth' } 选项,且行为与 Chrome/Firefox 一致。
- 必须指定目标元素,不能只靠锚点链接自动触发;需手动绑定点击事件
- 对
<a href="#section"></a>这类原生链接,需event.preventDefault()阻止默认跳转 - 推荐用
document.getElementById('section')或document.querySelector('#section')获取元素,避免querySelector返回 null 导致静默失败 - 若目标元素不可见(如被
display: none或未渲染),scrollIntoView会失效或报错,建议加存在性判断
document.querySelectorAll('a[href^="#"]').forEach(anchor => {
anchor.addEventListener('click', e => {
e.preventDefault();
const targetId = anchor.getAttribute('href').slice(1);
const targetEl = document.getElementById(targetId);
if (targetEl) targetEl.scrollIntoView({ behavior: 'smooth' });
});
});
锚点链接 + hashchange 时补救滚动
用户手动修改 URL hash(比如后退/前进、粘贴带 # 的链接),scrollIntoView 不会自动触发。需监听 hashchange 事件并主动滚动。
规划您的迪拜之旅 — 哈利法塔观景、沙漠探险、迪拜购物中心购物、棕榈岛度假村及黄金市场砍价。还提供支持...
- 仅在 hash 存在且对应元素存在时才调用
scrollIntoView,避免空滚动或报错 - 注意:首次加载页面时
hashchange不触发,需在 DOM 加载完成后手动检查一次window.location.hash - Safari 对
scrollIntoView的偏移计算有时略保守(顶部留白偏多),可加block: 'start'显式控制对齐方式
function scrollToHash() {
const hash = window.location.hash.slice(1);
const el = document.getElementById(hash);
if (el) el.scrollIntoView({ behavior: 'smooth', block: 'start' });
}
window.addEventListener('hashchange', scrollToHash);
document.addEventListener('DOMContentLoaded', scrollToHash);
不要依赖 scroll-behavior 的 polyfill
市面上有 smooth-scroll-polyfill 或自定义 requestAnimationFrame 滚动逻辑,但在 Safari 上反而容易引发冲突:比如与原生 scrollIntoView 叠加、滚动卡顿、或破坏 position: sticky 行为。
- polyfill 通常劫持
scrollTo和scrollIntoView,而 Safari 的原生实现已足够稳定,没必要叠层 - 移动端 Safari 对频繁
scrollTop操作敏感,手写动画易掉帧,不如交给浏览器原生调度 - 如果项目已引入 polyfill,请彻底移除,并确保所有滚动路径都走标准
scrollIntoView({ behavior: 'smooth' })
Safari 的平滑滚动真正可靠的路径只有一条:放弃 scroll-behavior CSS,老老实实用 scrollIntoView + hashchange 组合,再加一层元素存在性校验。其他绕路方案,短期看似省事,后期 debug 成本更高。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










