keep-alive

  • Props

    • include - 字符串或正则表达式。只有名称匹配的组件会被缓存。
    • exclude - 字符串或正则表达式。任何名称匹配的组件都不会被缓存。
    • max - 数字。最多可以缓存多少组件实例。
  • 用法

<keep-alive> 包裹动态组件时,会缓存不活动的组件实例,而不是销毁它们。和 <transition> 相似,<keep-alive> 是一个抽象组件:它自身不会渲染一个 DOM 元素,也不会出现在父组件链中。

当组件在 <keep-alive> 内被切换,它的 activateddeactivated 这两个生命周期钩子函数将会被对应执行。

在 2.2.0 及其更高版本中,activateddeactivated 将会在 <keep-alive> 树内的所有嵌套组件中触发。

主要用于保留组件状态或避免重新渲染。

  1. <!-- 基本 -->
  2. <keep-alive>
  3. <component :is="view"></component>
  4. </keep-alive>
  5. <!-- 多个条件判断的子组件 -->
  6. <keep-alive>
  7. <comp-a v-if="a > 1"></comp-a>
  8. <comp-b v-else></comp-b>
  9. </keep-alive>
  10. <!-- 和 `<transition>` 一起使用 -->
  11. <transition>
  12. <keep-alive>
  13. <component :is="view"></component>
  14. </keep-alive>
  15. </transition>

注意,<keep-alive> 是用在其一个直属的子组件被开关的情形。如果你在其中有 v-for 则不会工作。如果有上述的多个条件性的子元素,<keep-alive> 要求同时只有一个子元素被渲染。

  • include and exclude

2.1.0 新增

includeexclude 属性允许组件有条件地缓存。二者都可以用逗号分隔字符串、正则表达式或一个数组来表示:

  1. <!-- 逗号分隔字符串 -->
  2. <keep-alive include="a,b">
  3. <component :is="view"></component>
  4. </keep-alive>
  5. <!-- 正则表达式 (使用 `v-bind`) -->
  6. <keep-alive :include="/a|b/">
  7. <component :is="view"></component>
  8. </keep-alive>
  9. <!-- 数组 (使用 `v-bind`) -->
  10. <keep-alive :include="['a', 'b']">
  11. <component :is="view"></component>
  12. </keep-alive>

匹配首先检查组件自身的 name 选项,如果 name 选项不可用,则匹配它的局部注册名称 (父组件 components 选项的键值)。匿名组件不能被匹配。

  • max

2.5.0 新增

最多可以缓存多少组件实例。一旦这个数字达到了,在新实例被创建之前,已缓存组件中最久没有被访问的实例会被销毁掉。

  1. <keep-alive :max="10">
  2. <component :is="view"></component>
  3. </keep-alive>

<keep-alive> 不会在函数式组件中正常工作,因为它们没有缓存实例。