vue3 内置组件KeepAlive的使用

<KeepAlive> 是一个内置组件,它的功能是在多个组件间动态切换时缓存被移除的组件实例。

基本使用

keepAlive 通常用于包裹动态组件,以实现缓存功能。其基本语法如下:

复制代码
// 父组件CompKeepAlive.vue 
<script setup>
import { shallowRef } from 'vue'
import CompA from './CompA.vue'
import CompB from './CompB.vue'

const current = shallowRef(CompA)
</script>

<template>
  <div class="demo">
    <label><input type="radio" v-model="current" :value="CompA" /> A</label>
    <label><input type="radio" v-model="current" :value="CompB" /> B</label>
    <KeepAlive>
      <component :is="current"></component>
    </KeepAlive>
  </div>
</template>

// 子组件 CompA.vue
<script setup>
import { ref } from 'vue'

const count = ref(0)
</script>

<template>
  <p>Current component: A</p>
  <span>count: {{ count }}</span>
  <button @click="count++">+</button>
</template>

// 子组件 CompB.vue
<script setup>
import { ref } from 'vue'
const msg = ref('')
</script>

<template>
  <p>Current component: B</p>
  <span>Message is: {{ msg }}</span>
  <input v-model="msg">
</template>

包裹了动态组件 。当 current 的值切换时,被缓存的组件不会被销毁,而是被保留在内存中,以便下次切换时快速渲染

包含/排除

keepAlive 提供了 include 和 exclude 属性,用于控制哪些组件需要被缓存,哪些组件需要被排除。

  • include:指定需要被缓存的组件名称。可以是一个字符串或正则表达式。

  • exclude:指定不需要被缓存的组件名称。可以是一个字符串或正则表达式

    <KeepAlive include="a,b"> <component :is="current" /> </KeepAlive> <KeepAlive :include="/a|b/"> <component :is="current" /> </KeepAlive> <KeepAlive :include="['a', 'b']"> <component :is="current" /> </KeepAlive>

exclude组件

复制代码
<keep-alive :exclude="['CompB']">
  <component :is="current"></component>
</keep-alive>
最大缓存实例数

keepAlive 提供了一个 max 属性,用于限制缓存实例的最大数量。当缓存实例数量超过 max 时,最早缓存的实例会被移除

复制代码
<KeepAlive :max="1">
  <component :is="current" />
</KeepAlive>
 // CompA.vue 会被缓存
缓存实例的生命周期

对于缓存的组件来说,再次进入时,我们是不会执行created或者mounted等生命周期函数的:

  • 但是有时候我们确实希望监听到何时重新进入到了组件,何时离开了组件;

  • 这个时候我们可以使用activated 和 deactivated 这两个生命周期钩子函数来监听;

    <script setup> import { ref ,onActivated,onDeactivated } from 'vue' onActivated(()=>{ console.log('onActivated-- compA')

    })
    onDeactivated(()=>{
    console.log('onDeactivated --compA')
    })
    const count = ref(0)
    </script>

    <template>

    Current component: A

    count: {{ count }} <button @click="count++">+</button> </template>

请注意:

  • onActivated 在组件挂载时也会调用,并且 onDeactivated 在组件卸载时也会调用。

  • 这两个钩子不仅适用于 缓存的根组件,也适用于缓存树中的后代组件。

路由组件缓存​​:需配合 vue-router 的 使用
复制代码
<template>
<keep-alive :include="cachedComponents" :max="3">
  <router-view></router-view>
</keep-alive>
</template>

<script>
export default {
data() {
  return {
    cachedComponents: ['Home', 'Profile'] // 需要缓存的组件名
  };
}
};
</script>
相关推荐
加班是不可能的,除非双倍日工资2 小时前
css预编译器实现星空背景图
前端·css·vue3
wyiyiyi2 小时前
【Web后端】Django、flask及其场景——以构建系统原型为例
前端·数据库·后端·python·django·flask
gnip3 小时前
vite和webpack打包结构控制
前端·javascript
excel3 小时前
在二维 Canvas 中模拟三角形绕 X、Y 轴旋转
前端
阿华的代码王国3 小时前
【Android】RecyclerView复用CheckBox的异常状态
android·xml·java·前端·后端
一条上岸小咸鱼3 小时前
Kotlin 基本数据类型(三):Booleans、Characters
android·前端·kotlin
Jimmy3 小时前
AI 代理是什么,其有助于我们实现更智能编程
前端·后端·ai编程
草梅友仁3 小时前
草梅 Auth 1.4.0 发布与 ESLint v9 更新 | 2025 年第 33 周草梅周报
vue.js·github·nuxt.js
ZXT4 小时前
promise & async await总结
前端
Jerry说前后端4 小时前
RecyclerView 性能优化:从原理到实践的深度优化方案
android·前端·性能优化