keep-alive：组件级缓存-白红宇

title: keep-alive：组件级缓存 tags:

keep-alive

vue-router

页面缓存

在Vue构建的单页面应用（SPA）中，路由模块一般使用vue-router。vue-router不保存被切换组件的状态，它进行push或者replace时，旧组件会被销毁，而新组件会被新建，走一遍完整的生命周期。

但有时候，我们有一些需求，比如跳转到详情页面时，需要保持列表页的滚动条的深度，等返回的时候依然在这个位置，这样可以提高用户体验。在Vue中，对于这种“页面缓存”的需求，我们可以使用keep-alive组件来解决这个需求。

使用方式

keep-alive是个抽象组件（或称为功能型组件），实际上不会被渲染在DOM树中。它的作用是在内存中缓存组件（不让组件销毁），等到下次再渲染的时候，还会保持其中的所有状态，并且会触发activated钩子函数。因为缓存的需要通常出现在页面切换时，所以常与router-view一起出现：


    	
     
    复制代码

如此一来，每一个在router-view中渲染的组件，都会被缓存起来。

如果只想渲染某一些页面/组件，可以使用keep-alive组件的include/exclude属性。include属性表示要缓存的组件名（即组件定义时的name属性），接收的类型为string、RegExp或string数组；exclude属性有着相反的作用，匹配到的组件不会被缓存。假如可能出现在同一router-view的N个页面中，我只想缓存列表页和详情页，那么可以这样写：


      
     
    复制代码

实现条件缓存：全局的include数组

上面include的写法不是常用的，因为它固定了哪几个页面缓存或不缓存，假如有下面这个场景：

现有页面：首页（A）、列表页（B）、详情页（C），一般可以从：A->B->C；

B到C再返回B时，B要保持列表滚动的距离；

B返回A再进入B时，B不需要保持状态，是全新的。

很明显，这个例子中，B是“条件缓存”的，C->B时保持缓存，A->B时放弃缓存。其实解决方案也不难，只需要将B动态地从include数组中增加/删除就行了。具体步骤是：

在Vuex中定义一个全局的缓存数组，待传给include：

// global.jsexport default {  namespaced: true,  state: {    keepAliveComponents: [] // 缓存数组  },  mutations: {    keepAlive (state, component) {      // 注：防止重复添加（当然也可以使用Set）      !state.keepAliveComponents.includes(component) &&         state.keepAliveComponents.push(component)    },    noKeepAlive (state, component) {      const index = state.keepAliveComponents.indexOf(component)      index !== -1 &&        state.keepAliveComponents.splice(index, 1)    }  }}复制代码

在父页面中定义keep-alive，并传入全局的缓存数组：

// App.vue
      
       
         
        
     
    
export default {  computed: {    ...mapState({      keepAliveComponents: state => state.global.keepAliveComponents    })  }}复制代码

缓存：在路由配置页中，约定使用meta属性keepAlive，值为true表示组件需要缓存。在全局路由钩子beforeEach中对该属性进行处理，这样一来，每次进入该组件，都进行缓存：

const router = new Router({  routes: [    {      path: '/A/B',      name: 'B',      component: B,      meta: {        title: 'B页面',        keepAlive: true // 这里指定B组件的缓存性      }    }  ]})router.beforeEach((to, from, next) => {  // 在路由全局钩子beforeEach中，根据keepAlive属性，统一设置页面的缓存性  // 作用是每次进入该组件，就将它缓存  if (to.meta.keepAlive) {    store.commit('global/keepAlive', to.name)  }})复制代码

取消缓存的时机：对缓存组件使用路由的组件层钩子beforeRouteLeave。因为B->A->B时不需要缓存B，所以可以认为：当B的下一个页面不是C时取消B的缓存，那么下次进入B组件时B就是全新的：

export default {  name: 'B',  created () {      // ...设置滚动条在最顶部  },  beforeRouteLeave (to, from, next) {    // 如果下一个页面不是详情页（C），则取消列表页（B）的缓存    if (to.name !== 'C') {        this.$store.commit('global/noKeepAlive', from.name)    }    next()  }}复制代码

因为B的条件缓存，是B自己的职责，所以最好把该业务逻辑写在B的内部，而不是A中，这样不至于让组件之间的跳转关系变得混乱。

一个需要注意的细节：因为keep-alive组件的include数组操作的对象是组件名、而不是路由名，因此我们定义每一个组件时，都要显式声明name属性，否则缓存不起作用。而且，一个显式的name对Vue devtools有提示作用。

另一种方式？

网上看到实现条件缓存的另一种方式很类似，但它是在父组件中，使用两个router-view并进行条件渲染：

在GitHub的issue中（见参考链接）有一些争议，本人也还没有比较全面的验证过，所以也暂不知道效果如何。

Q&A

Q：组件名已经加入全局include数组了，为什么页面还是没有缓存到？

A：如果按照上面的思路来做就没有问题，注意第5点，即很有可能你忘记给组件声明一个name属性了。

Q：组件能够缓存，但是滚动条并没有缓存、比如还是会回到顶部？

A：滚动条这个问题跟组件的HTML结构有关。浅显而言，keep-alive功能缓存的是父元素相对于组件的scrollTop，所以如果你的组件/页面设置了height:100%、滚动条在组件内部的，看到的滚动条就是没有缓存的。当然，关于这个，还有待进入源码深究，给自己留个坑吧。

参考

文档

应用

讨论

https://github.com/vuejs/vue-router/issues/811