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

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 3 组合式 API 与
热门下载
相关下载
精品课程
相关推荐
/
热门推荐
/
最新课程
最新文章
