Vue 3 组合式函数怎么处理页面滚动条位置的记忆保存

老晨同学_5913

老晨同学_5913

2026-10-19

811人浏览

原创

usescrollposition 封装滚动位置记忆逻辑,支持 localstorage/sessionstorage/内存存储,自动监听、保存、恢复、清理;适配 keep-alive 与路由跳转,需确保容器可滚动、内容渲染完成后再恢复位置。

vue 3 组合式函数怎么处理页面滚动条位置的记忆保存

Vue 3 组合式函数处理滚动位置记忆,核心是把“存位置”和“恢复位置”逻辑抽离成可复用、可配置的逻辑单元。它不依赖页面具体结构,而是通过传入 DOM ref、存储策略(localStorage/sessionStorage)、唯一标识等参数,自动完成监听、保存、恢复、清理全流程。

用 useScrollPosition 封装通用逻辑

定义一个组合式函数 useScrollPosition,接收滚动容器 ref 和可选配置:

  • 默认使用 localStorage 持久化,适合刷新/重启后仍需恢复的场景(如文章页)
  • 支持传入 key,比如 `scroll_${route.path}` 或 `scroll_${route.name}_${id}`,避免不同列表互相覆盖
  • 内部自动绑定 @scroll 事件,节流防抖写入存储(推荐用 requestIdleCallback 或简单 setTimeout 延迟写入)
  • 在 onActivated(keep-alive 场景)或 onMounted + nextTick(非缓存场景)中读取并恢复
  • 在 onBeforeUnmount 或 beforeRouteLeave 中触发保存,确保离开前数据最新

适配 keep-alive 缓存组件

当页面被 <keep-alive></keep-alive> 包裹时,组件不会销毁,但 DOM 会脱离文档流再重挂载,导致 scrollTop 重置为 0。此时需利用 onActivated 钩子恢复:

vue-composition-api-best-practices
vue-composition-api-best-practices

Vue 3 组合式 API 与

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 17.1万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习

Vue.js 微实战--十天技能课堂
Vue.js 微实战--十天技能课堂

共18课时 | 1.7万人学习