路由复用问题
当路由匹配路径未发生变化时,只是相关的参数发生了变化,路由跳转时,会发现虽然地址栏中的地址更新到了新的链接,但是页面渲染并未触发响应路由组件的created
,mounted
等钩子函数,也就意味着组件并没有被重新创建,也就是路由复用问题。
在官方文档中,下面这段话同样体现了这个问题。
了解vue组件复用的应该知道,复用时并不会更新组件内部自身data中拥有的响应式属性,但是如果是通过props传递过来的属性,在复用组件时,进行diff patch时,是会更新的。具体组件复用更新原理不清楚的,可以参考博客组件复用
vue-router在匹配到对应的路由后,同样会更新对应组件的props参数,相关实现逻辑在router-view
组件的render函数中有体现,其中fillPropsinData
将路由表中的props参数传递给路由组件的props
var configProps = matched.props && matched.props[name];// save route and configProps in cacheif (configProps) {extend(cache[name], {route: route,configProps: configProps});fillPropsinData(component, data, route, configProps);}
具体怎么设置props呢?可以参考官方文档 路由组件传参
props参数复用更新
下面是一个简单的 detail.vue 示例,用于显示详情页面。假设我们通过路由参数 id 来获取并显示特定项的详细信息。
首先,确保你的路由配置中包含了 detail 路由,并且能够传递 id 参数。例如:
// router/index.js
import Vue from 'vue';
import Router from 'vue-router';
import List from '@/page/list.vue';
import Detail from '@/page/detail.vue';Vue.use(Router);export default new Router({routes: [{path: '/list',name: 'List',component: List},{path: '/detail/:id',name: 'Detail',component: Detail}]
});
下面是一个简单的 list.vue 示例,其中包含一个列表,列表项可以跳转到详情页面。假设详情页面的路由为 /detail/:id。
<template><div><ul><li v-for="item in list" :key="item.id" @click="goToDetail(item.id)">{{ item.name }}</li></ul></div>
</template><script>
export default {data() {return {list: [{ id: 1, name: 'Item 1' },{ id: 2, name: 'Item 2' },{ id: 3, name: 'Item 3' },// 更多列表项...]};},methods: {goToDetail(id) {this.$router.push({ path: `/detail/${id}` });}}
};
</script><style scoped>
ul {list-style-type: none;padding: 0;
}li {padding: 8px;cursor: pointer;border-bottom: 1px solid #ccc;
}li:hover {background-color: #f0f0f0;
}
</style>
接下来是 detail.vue 的代码:
<template><div><h1>Detail Page - {{id}} </h1><div v-if="item"><h2>{{ item.name }}</h2><p>ID: {{ item.id }}</p><p>Description: {{ item.description }}</p></div><div v-else><p>Loading...</p></div><button @click="goBack">Back to List</button><button @click="goToDetail">Go to other detail 2</button></div>
</template><script>
export default {props: ['id'],data() {return {item: null};},created() {this.fetchItem();},methods: {fetchItem() {const id = this.$route.params.id;// 假设我们有一个方法来获取数据,这里用模拟数据代替const items = [{ id: 1, name: 'Item 1', description: 'Description for Item 1' },{ id: 2, name: 'Item 2', description: 'Description for Item 2' },{ id: 3, name: 'Item 3', description: 'Description for Item 3' }];this.item = items.find(item => item.id === parseInt(id));},goBack() {this.$router.push({ name: 'List' });},goToDetail() {this.$router.replace({ name: 'Detail', params: { id: 2 } })}}
};
</script><style scoped>
h1 {font-size: 24px;margin-bottom: 20px;
}h2 {font-size: 20px;margin-bottom: 10px;
}p {margin: 5px 0;
}button {margin-top: 20px;padding: 10px 20px;background-color: #007bff;color: white;border: none;cursor: pointer;
}button:hover {background-color: #0056b3;
}
</style>
从列表跳转到详情页时,可以正常的更新渲染,但是可以到详情页之间互相跳转时,页面的渲染是有问题的。以上面为例,从detail page 3跳转到 detail page 2时,只更新了title 中的id,而对应的内容并没有更新。
从detail.vue的template中可以看到,组件中props中的id对应的渲染更新了,而item作为组件自身内部响应式并没有更新。因为item的赋值逻辑是在created里触发的,而详情页跳转详情页的情况,是不会触发created的。
渲染更新
如果想让详情页之间的跳转能够及时地更新,要如何做呢?也就是最初上面官网上介绍的,如何响应路由参数的变化?官方给出的方案有相中:
路由守卫
虽然相同路由之间跳转,不会触发created等钩子函数,但是会触发路由守卫函数beforeRouteUpdate
,可以考虑将原先的数据初始化逻辑放到这里。以上面的例子为例,可以在代码中加入下面的代码来触发页面的更新:
beforeRouteUpdate (to, from, next) {console.log('=====beforeRouteUpdate====',to.params.id, this.id)this.fetchItem(to.params.id)next()
}
//这里id改为传入的,以便上面方法中能够传入最新的路由参数
fetchItem(id) {// 假设我们有一个方法来获取数据,这里用模拟数据代替const items = [{ id: 1, name: 'Item 1', description: 'Description for Item 1' },{ id: 2, name: 'Item 2', description: 'Description for Item 2' },{ id: 3, name: 'Item 3', description: 'Description for Item 3' }];this.item = items.find(item => item.id === parseInt(id));}
这里需要注意使用的是beforeRouteUpdate
,而不是beforeRouteEnter
,经实际验证,beforeRouteEnter
只在从其他路由进入该路由时触发,而在像详情页跳转详情页这样的路由复用时,不会触发。
watch监听路由变化
官网给出的解决方法,除了路由守卫,就是监听$route
,加入下面的代码,同样可以达到对应的效果。
watch: {'$route' (to, from) {console.log('=====watch====',to.params.id, this.id)this.fetchItem(to.params.id)}},
打破路由复用
上面的两种方法虽然都能达到路由试图随参数变化而更新,但是本质上还是在复用的基础上,在合适的时机重新触发处理逻辑函数,已达到更新目的。由于是复用的实例,所以在更新时并不会主动销毁之前创建的资源,如果有销毁的需求,比如每次进入详情页都会创建一些canvas等,在路由参数发生变化时,需要重新绘制,通常是需要先销毁之前的,再重新绘制新的,而采用上面两种方法,在复用渲染时,需要我们手动去管理这些。
如果我们期望的是不管路由是不是从详情页跳转详情页复用,每次参数变化时,不复用之前的,销毁之前创建的组件实例,然后重新创建新的组件实例,要如何做呢?
使用 key
强制重新渲染,通过为组件设置一个唯一的 key,Vue 会认为这是一个不同的组件实例,从而强制重新渲染。
<template><router-view :key="$route.fullPath"></router-view>
</template>
上面直接在route-view上绑定key值,会影响所有的路由,如果只想针对详情页路由处理,可以直接在组件上使用 key:
<!-- 这里新建一个wrapper.vue 路由组件,修改路由表里的detail路由对应的组件为这个wrapper.vue组件 -->
<template><!-- Detail 组件 --><Detail v-bind="$attrs" :key="$route.params.id"></Detail>
</template>
注意上面直接在路由组件上绑定key值时,需将原有Detail路由组件作为新的路由组件的子组件。因为相同的路径对应的路由还是默认会走vue-router的组件复用逻辑,如果直接在原有的Detail组件内部绑定key值是起不到作用的,这里修改新的路由组件为wrapper.vue组件,复用时也是复用的wrapper组件,在对wrapper组件进行diff算法更新时,由于key值不同,会重新触发子组件的渲染,此时就会重新触发Detail组件的created
钩子函数,同时也会触发先前组件的beforeDestroy
钩子函数,销毁之前的实例。