Skip to content

滚动位置被意外恢复

快速摘要

刷新后页面跳到旧滚动位置——而你的 SPA 期望从顶部开始。

为什么发生

  • 默认 history.scrollRestoration 为 'auto' 会恢复滚动

  • SPA 刷新期望顶部但浏览器恢复缓存位置

  • 长内容中恢复滚动让用户觉得是 bug

最小示例

✗ 错误代码
// default: history.scrollRestoration === 'auto'
// reload jumps to old scroll position unexpectedly
✓ 修复代码
if ('scrollRestoration' in history) {
  history.scrollRestoration = 'manual';
}
window.scrollTo(0, 0); // start at top on load

浏览器默认恢复滚动。设 scrollRestoration 为 'manual' 把控制权交给 SPA,scrollTo(0,0) 确保从顶部开始。

如何诊断

  • 检查 history.scrollRestoration——若为 'auto' 则浏览器恢复滚动

  • 刷新并观察页面是否跳到非顶部位置

  • 加载时记录 window.scrollY 看恢复值

如何修复

  • 设 history.scrollRestoration = 'manual' 并自行控制滚动

  • 加载时调用 window.scrollTo(0, 0) 从顶部开始

  • 仅对有意义的路由恢复滚动

如何预防

  • SPA 中设 scrollRestoration 为 'manual' 并显式处理滚动

  • 按路由决定是否需要滚动恢复

相关资源

相关术语

相关课程

  • DOM

    学习滚动。

← 返回语言