Vue3中keep-alive的使用及注意事项说明

 更新时间:2025年04月17日 10:55:06   作者:大樊子  
这篇文章主要介绍了Vue3中keep-alive的使用及注意事项说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

Vue3中keep-alive使用及注意事项

keep-alive 是 Vue 内置的一个抽象组件,用于缓存不活动的组件实例,避免重复渲染,提高性能。

以下是它的详细用法和注意事项:

基本用法

<template>
  <!-- 基本用法 -->
  <keep-alive>
    <component :is="currentComponent"></component>
  </keep-alive>

  <!-- 缓存特定组件 -->
  <keep-alive include="CompA,CompB" exclude="CompC">
    <router-view></router-view>
  </keep-alive>
</template>

主要功能

  • 组件缓存:当组件切换时,保留组件状态(如数据、滚动位置等)
  • 避免重复渲染:减少不必要的 DOM 操作和生命周期钩子执行
  • 保留状态:保持表单输入内容、滚动位置等

核心属性

生命周期钩子

keep-alive 缓存的组件会触发特有的生命周期钩子:

  • onActivated:组件被激活时调用(进入缓存组件)
  • onDeactivated:组件被停用时调用(离开缓存组件)
import { onActivated, onDeactivated } from 'vue'

export default {
  setup() {
    onActivated(() => {
      console.log('组件被激活')
    })
    
    onDeactivated(() => {
      console.log('组件被停用')
    })
  }
}

与 Vue Router 结合使用

<template>
  <keep-alive :include="cachedViews">
    <router-view v-slot="{ Component }">
      <transition name="fade">
        <component :is="Component" />
      </transition>
    </router-view>
  </keep-alive>
</template>

<script>
import { ref } from 'vue'
export default {
  setup() {
    const cachedViews = ref(['Home', 'User'])
    return { cachedViews }
  }
}
</script>

注意事项

组件必须有 name 选项includeexclude 匹配的是组件的 name 选项

动态组件切换问题

  • 使用 key 属性强制重新渲染:
<keep-alive><comp :key="id"></comp></keep-alive>
  • 或者使用 v-if 控制:
<comp v-if="show"></comp>

内存占用

  • 缓存过多组件可能导致内存占用过高
  • 使用 max 属性限制缓存数量

数据更新时机

  • 缓存的组件不会重新创建,因此 created/mounted 不会再次触发
  • 应在 activated 中处理数据刷新逻辑

滚动行为

  • 默认会保持滚动位置
  • 如需重置滚动位置,可在 activated 中处理:
onActivated(() => {
  window.scrollTo(0, 0)
})

与 Transition 一起使用

<router-view v-slot="{ Component }">
  <transition name="fade">
    <keep-alive>
      <component :is="Component" />
    </keep-alive>
  </transition>
</router-view>

最佳实践

  • 只缓存必要的组件(如表单页、列表页)
  • 对需要频繁切换但状态需要保留的组件使用
  • 避免缓存大型组件或包含大量数据的组件
  • 在路由元信息中管理缓存:
const routes = [
  {
    path: '/user',
    component: User,
    meta: { keepAlive: true }
  }
]

通过合理使用 keep-alive,可以显著提升应用性能,特别是在移动端或需要频繁切换视图的场景中。

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • 一文搞懂Vue3中的异步组件defineAsyncComponentAPI的用法

    一文搞懂Vue3中的异步组件defineAsyncComponentAPI的用法

    这篇文章主要介绍了一文搞懂Vue3中的异步组件,文章围绕主题展开详细的内容介绍,具有一定的参考价值,需要的小伙伴可以参考一下
    2022-07-07
  • vue实现移动端可拖拽式icon图标

    vue实现移动端可拖拽式icon图标

    这篇文章主要为大家详细介绍了vue实现移动端可拖拽式icon图标,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-03-03
  • Pinia中action使用方法详解

    Pinia中action使用方法详解

    Pinia是Vue的存储库,它允许您跨组件/页面共享状态,下面这篇文章主要给大家介绍了Pinia中action使用方法的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2023-04-04
  • 在 Vue 中使用 dhtmlxGantt 组件时遇到的问题汇总(推荐)

    在 Vue 中使用 dhtmlxGantt 组件时遇到的问题汇总(推荐)

    dhtmlxGantt一个功能丰富的甘特图插件,支持任务编辑,资源分配和多种视图模式,这篇文章主要介绍了在 Vue 中使用 dhtmlxGantt 组件时遇到的问题汇总,需要的朋友可以参考下
    2023-03-03
  • Vue设计器form-create-designer配置表单默认值示例详解

    Vue设计器form-create-designer配置表单默认值示例详解

    这篇文章主要介绍了如何使用开源项目form-create-designer来灵活调整表单的默认值,通过config.formOptions,您可以自定义表单的全局布局,文章提供了一个详细的例子,展示了如何使用form-create-designer的配置选项来调整表单的布局和外观,感兴趣的朋友一起看看吧
    2024-11-11
  • vue+intro.js插件实现引导功能

    vue+intro.js插件实现引导功能

    使用 intro.js这个插件,来实现一个引导性的效果,经常在一些新手引导页遇到这样的需求,下面通过本文给大家分享vue+intro.js插件实现引导功能,感兴趣的朋友一起看看吧
    2024-06-06
  • Vue路由Hash模式分析

    Vue路由Hash模式分析

    Vue-router是Vue的核心组件,主要是作为Vue的路由管理器,Vue-router默认hash模式,本文讲给大家详细分析Vue路由Hash模式,文中有相关的代码示例供大家参考,感兴趣的同学可以借鉴一下
    2023-06-06
  • 详解vue2如何实现点击预览本地文件

    详解vue2如何实现点击预览本地文件

    这篇文章主要为大家详细介绍了vue2如何实现点击预览本地的word、excle、pdf文件,感兴趣的小伙伴可以跟随小编一起学习一下
    2024-04-04
  • vue-cli3添加模式配置多环境变量的方法

    vue-cli3添加模式配置多环境变量的方法

    这篇文章主要介绍了vue-cli3添加模式配置多环境变量的方法,本文通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-06-06
  • Vue-Router模式和钩子的用法

    Vue-Router模式和钩子的用法

    本篇文章主要介绍了Vue-Router模式和钩子的用法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-02-02

最新评论