vue3中如何缓存路由组件

在 Vue3 中缓存路由组件,主要借助<keep-alive>组件来实现,具体方法如下:

1. 全局缓存路由组件

在 App.vue 等根组件中,直接将<router-view>包裹在<keep-alive>标签内,这样所有的路由组件都会被缓存。

TypeScript 复制代码
<template>
  <keep-alive>
    <router-view></router-view>
  </keep-alive>
</template>

2. 缓存特定路由组件

如果只想缓存部分路由组件,可通过<keep-alive>includeexclude属性来控制。

  • 使用include缓存指定组件include接受字符串或正则表达式,代表需要缓存的组件名称。
    首先,确保每个需要缓存的路由组件都设置了name属性 ,如在Home.vue中:

    TypeScript 复制代码
    <template>
      <!-- 组件内容 -->
    </template>
    
    <script setup>
    import { defineComponent } from 'vue';
    export default defineComponent({
      name: 'Home' // 设置组件名称
    });
    </script>

    然后,在根组件中使用keep-alive并配置include

    TypeScript 复制代码
    <template>
      <keep-alive :include="['Home', 'About']"> 
        <router-view></router-view>
      </keep-alive>
    </template>

    这样只有HomeAbout这两个路由组件会被缓存。

  • 使用exclude排除不缓存的组件 :例如,希望除了Login组件外其他都缓存,可如下设置:

    TypeScript 复制代码
    <template>
      <keep-alive :exclude="['Login']"> 
        <router-view></router-view>
      </keep-alive>
    </template>

3. 结合路由元信息(meta)动态控制缓存

在路由配置文件(如router.js)中,利用meta字段添加自定义属性,标识该路由组件是否需要缓存。

TypeScript 复制代码
import { createRouter, createWebHistory } from 'vue-router';
const router = createRouter({
  history: createWebHistory(),
  routes: [
    {
      path: '/',
      name: 'Home',
      component: () => import('@/views/Home.vue'),
      meta: { keepAlive: true } // 标识该页面需要缓存
    },
    {
      path: '/about',
      name: 'About',
      component: () => import('@/views/About.vue'),
      meta: { keepAlive: false } // 标识该页面不需要缓存
    }
  ]
});

export default router;

在根组件中,根据meta中的keepAlive属性值动态决定是否使用keep-alive包裹:

TypeScript 复制代码
<template>
  <router-view v-slot="{ Component, route }">
    <keep-alive v-if="route.meta.keepAlive">
      <component :is="Component"></component>
    </keep-alive>
    <component :is="Component" v-else></component>
  </router-view>
</template>

4. 处理缓存组件的生命周期

使用keep-alive缓存的组件,mountedunmounted钩子函数不会被调用,取而代之的是activated(组件被激活时调用)和deactivated(组件失活被缓存时调用) 。例如,在需要缓存的组件中:

TypeScript 复制代码
import { onActivated, onDeactivated } from 'vue';

onActivated(() => {
  // 组件被激活时执行,如重新获取数据等
});

onDeactivated(() => {
  // 组件被缓存时执行,如清理定时器等
});

5. 处理动态路由参数变化

当路由参数发生变化(例如/user/1切换到/user/2),默认缓存的组件不会重新渲染。可以通过监听$route对象的变化来手动更新组件:

TypeScript 复制代码
import { useRoute, watch } from 'vue-router';
const route = useRoute();
watch(
  () => route.params,
  (newParams, oldParams) => {
    // 路由参数变化时执行,如重新请求数据
  },
  { immediate: true }
);

6. 管理缓存状态(可选)

  • 限制缓存数量 :避免缓存过多页面导致内存占用过高,可以设置最大缓存数量,当超过时,清理掉最早的缓存。例如结合watchref来实现:

    TypeScript 复制代码
    import { ref, watch } from 'vue';
    const cachedViews = ref([]);
    const MAX_CACHE = 10; // 最大缓存数量
    watch(cachedViews, (val) => {
      if (val.length > MAX_CACHE) {
        cachedViews.value = val.slice(-MAX_CACHE);
      }
    });
  • 缓存状态持久化 :使用localStorage等存储方式保存缓存状态,在应用重启时恢复之前的缓存。

    TypeScript 复制代码
    import { onMounted, watch } from 'vue';
    const cachedViews = ref([]);
    onMounted(() => {
      const saved = localStorage.getItem('cachedViews');
      if (saved) {
        cachedViews.value = JSON.parse(saved);
      }
    });
    watch(cachedViews, (val) => {
      localStorage.setItem('cachedViews', JSON.stringify(val));
    });
相关推荐
Mr Xu_13 小时前
告别冗长 switch-case:Vue 项目中基于映射表的优雅路由数据匹配方案
前端·javascript·vue.js
老毛肚13 小时前
MyBatis插件原理及Spring集成
java·spring·mybatis
前端摸鱼匠13 小时前
Vue 3 的toRefs保持响应性:讲解toRefs在解构响应式对象时的作用
前端·javascript·vue.js·前端框架·ecmascript
未来之窗软件服务15 小时前
未来之窗昭和仙君(六十五)Vue与跨地区多部门开发—东方仙盟练气
前端·javascript·vue.js·仙盟创梦ide·东方仙盟·昭和仙君
phltxy16 小时前
Vue 核心特性实战指南:指令、样式绑定、计算属性与侦听器
前端·javascript·vue.js
ALex_zry17 小时前
Redis Cluster 分布式缓存架构设计与实践
redis·分布式·缓存
Byron070717 小时前
Vue 中使用 Tiptap 富文本编辑器的完整指南
前端·javascript·vue.js
Byron070719 小时前
从 0 到 1 搭建 Vue 前端工程化体系:提效、提质、降本实战落地
前端·javascript·vue.js
zhengfei61119 小时前
【AI平台】- 基于大模型的知识库与知识图谱智能体开发平台
vue.js·语言模型·langchain·知识图谱·多分类
徐小夕@趣谈前端19 小时前
Web文档的“Office时刻“:jitword共建版2.0发布!让浏览器变成本地生产力
前端·数据结构·vue.js·算法·开源·编辑器·es6