Vue3嵌套路由中使用keep-alive缓存多层的实现

2024-05-27
7153 分钟
...
目录
  • 前言
  • Demo项目结构
  • 路由层级扁平化
  • 给所有的 router-view 都嵌套上 keep-alive

前言

keep-alive是Vue中的缓存标签, 组件在标签中的内容会被缓存下来;但是在多层嵌套的router-view中, 只能缓存到该层下的router-view, 由于路由嵌套比较常见,所以这里提供两种我觉得OK的解决方案。

解决思路

  • 路由层级扁平化,在路由守卫中执行一个拍平的函数,将需要缓存的路由提升到第一层,这样处理会影响到路由层级,最直白的影响如对 面包屑 等功能有直接影响
  • 把所有的 router-view 都通过 keep-alive 包裹起来, 通过keep-aliveinclude, exclude 来判断是否需要缓存。

Demo项目结构

router.ts

路由的结构大概是这样的 Layout > TableManage > (List, Detail, Add...)

路由层级扁平化

在路由的 afterEach 执行一个扁平化方法, 举例:



1.  import router from  '@/router/index'
2.  import  PageTitleUtils  from  '@/utils/PageTitleUtils'
3.  import  {  ElMessage  }  from  'element-plus'
4.  import useStore from  '@/store/index'
5.  import type {  RouteLocationNormalized,  NavigationGuardNext  }  from  'vue-router'
6.  import  NProgress  from  'nprogress'
7.  import  'nprogress/nprogress.css'

9.  NProgress.configure({ showSpinner:  false  })  // NProgress Configuration

11.  const  { user, routeStore }  = useStore()

13.  const whiteList =  \['/login'\]  // no redirect whitelist

15.  router.beforeEach(async (to:  RouteLocationNormalized,  from:  RouteLocationNormalized,  next:  NavigationGuardNext)  =>  {
16.    NProgress.start()
17.    if  (user.hasToken())  {
18.    if  (to.path ===  '/login')  {
19.    next({ path:  '/'  })
20.    NProgress.done()
21.    }  else  {
22.    if  (user.hasUserInfo())  {
23.    next()
24.    NProgress.done()
25.    }  else  {
26.    try  {
27.   await user.getUserInfo()
28.   await routeStore.setRoutes()
29.    next({  ...to, replace:  true  })
30.    NProgress.done()
31.    }  catch  (error: any)  {
32.   routeStore.resetRoutes()
33.   user.resetUserInfo()
34.    ElMessage.error(error ||  'Has Error')
35.    next(`/login?redirect=${to.fullPath}`)
36.    NProgress.done()
37.    }
38.    }
39.    }
40.    }  else  {
41.    /\* has no token */
42.    if  (whiteList.indexOf(to.path)  !==  -1)  {
43.    // in the free login whitelist, go directly
44.    next()
45.    NProgress.done()
46.    }  else  {
47.    // other pages that do not have permission to access are redirected to the login page.
48.    next(`/login?redirect=${to.fullPath}`)
49.    NProgress.done()
50.    }
51.    }
52.  })

54.  router.afterEach((to: any)  =>  {
55.    NProgress.done()
56.    // set page title
57.    const  { meta }: any = to
58.   document.title =  PageTitleUtils.getPageTitle(meta.title)
59.    // delayering router
60.   delayeringRoute(to)
61.  })

63.  /**
64.   \* 递归处理多余的 layout : <router-view>,
65.   \* 让需要访问的组件保持在第一层 index : <router-view> 之下
66.   */
67.  function delayeringRoute(to:  RouteLocationNormalized)  {
68.    if  (to.matched && to.matched.length >  2)  {
69.    for  (let i =  0; i < to.matched.length; i++)  {
70.    const element = to.matched\[i\]
71.    // 移除多余的 layout, 也许你项目中并不叫 layout ,自行修改此处
72.    if  (element.components?.default.name ===  'layout')  {
73.   to.matched.splice(i,  1)
74.   handleKeepAlive(to)
75.    }
76.    }
77.    }
78.  }

以上代码示例中, delayeringRoute 是移除多余 layout 的方法, 在路由的afterEach方法中去移除,弊端很明显, 路由的结构受到了影响

给所有的 router-view 都嵌套上 keep-alive

这是我比较推荐的一种方法, 没什么副作用,也不麻烦, 毕竟所有的 router-view 都一样,如果你使用的IDE是vscode,可以直接把这段代码写进项目中的代码片段, 方便使用。

Layout的Main



1.  <script  lang="ts"  setup  name="AppMain">
2.    import  { useRoute } from 'vue-router'
3.    import useStore from '@/store';
4.    import  { storeToRefs } from 'pinia';

6.    const route = useRoute()
7.    const  { tagview }  = useStore()
8.    const  { cacheList }  = storeToRefs(tagview)
9.  </script>

11.  <template>
12.    <div  class="app-main">
13.    <router-view  v-slot="{ Component }">
14.    <keep-alive :include="cacheList">
15.    <component :is="Component" :key="route.fullPath"  />
16.    </keep-alive>
17.    </router-view>
18.    </div>
19.  </template>

21.  <style  scoped  lang="scss">
22.  </style>

其他嵌套的路由, 不管几层,都可以这样处理



1.  <script  lang="ts"  setup  name="TableManage">
2.    import  { useRoute } from 'vue-router'
3.    import useStore from '@/store';
4.    import  { storeToRefs } from 'pinia';
5.    import  { onMounted } from 'vue';

7.    const route = useRoute()
8.    const  { tagview }  = useStore()
9.    const  { cacheList }  = storeToRefs(tagview)

11.   onMounted(()  =>  {
12.   tagview.addCacheList('TableManage')
13.    })

15.  </script>

17.  <template>
18.    <router-view  v-slot="{ Component }">
19.    <keep-alive :include="cacheList">
20.    <component :is="Component" :key="route.fullPath"  />
21.    </keep-alive>
22.    </router-view>
23.  </template>

这样就可以实现嵌套路由的缓存了。 附上演示

到此这篇关于Vue3嵌套路由中使用keep-alive缓存多层的实现的文章就介绍到这了,更多相关Vue3 keep-alive缓存多层内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们!

如果您觉得这篇文章有帮助,请点个赞吧~

分享文章

相关文章

更多文章 →
vue2025-10-22
shallowRef 与 ref 的区别、场景与坑位
结论先行: 会 深度 地把你放进去的对象转成响应式(递归代理),因此"对象内部的改动"也会触发视图更新。 只在 顶层 做依赖追踪: 更换 才触发更新 ;若你只是"在原对象上改属性",不会触发,除非手动 。 1\. 快速对比 维度 追踪粒度 深度(递归) 仅顶层 对象内部属性变更 会触发更新 不会 触发(除非 或重新赋值) 性能 有递归 & 依赖跟踪开销 更轻量,适合大对象/第三方实例 适用对象 普通标量、普通对象、数组 第三方实例(图表...
学习面试
vue2025-10-20
Vue 3 中的 setup执行时机与异步逻辑详解
Vue 3 中的 执行时机与异步逻辑详解 本文详细介绍 Vue 3 组合式 API 的核心函数 :它在组件生命周期中的执行时机、异步行为( 的影响)、常见用法和最佳实践。 一、 的执行时机 是 Vue 3 组件实例创建后、渲染前执行的函数。 它相当于 Vue 2 中的 和 的合体。 执行流程: 也就是说: 所有响应式数据( 、 、 )都在这里定义; 所有生命周期钩子( 、 等)都在这里注册; 模板渲染会等待 执行完成(或异步返回的 Pr...
学习面试
vue2025-10-08
vue中ref与reactive
Vue 3 的 与 :区别、实现,以及为什么更推荐 1\. 一句话结论 :适合 原始类型 或 独立、细粒度 的状态单元;类型推断明确、解构安全、追踪粒度更小, 默认首选 。 :适合管理 对象/集合 这类结构化状态;但 解构会丢失响应性 , 默认 非深度 ,需要正确的使用姿势配合。 2\. 用法与语义差异 2.1 基本示例 2.2 模板中的解包(unwrapping) 在 模板 里, 会 自动解包 ,可直接写 ,不必 。 在响应式对象中...
学习面试
vue2025-09-23
Vue3 中computed属性依赖总结
Vue3 属性依赖总结 1. 依赖收集机制 的 getter 内部 读取 到哪些响应式变量 ( / ),就会把这些变量收集为依赖。 当这些依赖发生变化时, 会重新计算。 2. 如果只返回常量 始终是 。 修改 或 不会触发 重新计算,因为 getter 内没有访问它们。 3. 如果访问了响应式变量但仍返回常量 初始化时会打印一次。 当 或 改变时,getter 会重新执行(再次打印),因为它们被收集为依赖。 但 依旧始终是 。 4. 总...
学习面试
vue2025-09-17
template标签为什么不可以使用v-show
前言 写 Vue 时,最容易踩的小坑之一,就是给 套一个 。编辑器不报错,页面却“消失”了。很多人以为这是 bug,其实它只是 Vue 的底层设计在默默提醒: 不是真节点,它只是个“草稿纸”。 一、为什么 拒绝 v show 的本质是切换元素的 CSS: 。浏览器要找到真实 DOM 节点,才能给它加样式。而 在运行时会被完全剥离,不会留下任何标签,Vue 找不到节点,也就无处下刀。 举个反面教材: 打开控制台,你会看到 还是生成了,但...
学习面试
vue2025-09-17
Vue 3中watchEffect自动追踪详解
Vue 3 自动追踪详解 一、是什么 是 Vue 3 Composition API 提供的一个响应式副作用(side effect)函数。 它会 立即执行一次回调函数 ,并且在回调函数中访问到的所有响应式数据(ref、reactive、computed 等)都会被 自动追踪 。 当这些依赖的响应式数据发生变化时,回调会重新执行。 简单理解: 能“自动发现”它用到的响应式变量,不需要手动指定依赖。 二、基本用法 特点: 第一次立即执行...
学习面试

评论

请登录后发表评论

去登录
加载评论中...

目录