Vue-Router 4.x
路由配置
与之前版本区别：
- 由
createRouter()替换new Router() - 路由模式由
createWebHistory()替换mode: 'history' - main.js中由
.use(router)替换new Vue({ router })
以前版本写法：
// router/index.js
import Vue from 'vue';
import Router from 'vue-router';
import routes from './routes'
Vue.use(Router);
const router = new Router({ // 区别1
mode: 'history', // 区别2
routes
});
export default router;
// main.js
import Vue from 'vue'
import router from './router'
// ...
new Vue({
el: '#app',
router, // 区别3
components: { App },
template: '<App/>'
})
vue-router 4.x 版本写法：
// router/index.js
import { createRouter, createWebHistory } from 'vue-router';
import routes from './routes'
const router = createRouter({ // 区别1
history: createWebHistory(process.env.BASE_URL), // 区别2
routes
})
export default router
// main.js
import { createApp } from 'vue'
import App from './App.vue'
import router from './router'
const app = createApp(App);
createApp(App).use(router).mount('#app'); // 区别3
路由模式区别：
| vue-router 3.x | vue-router 4.x |
|---|---|
| history | createWebHistory() |
| hash | createWebHashHistory() |
| abstract | createMemoryHistory() |
路由跳转及参数
router： 是VueRouter的一个全局对象，通过Vue.use(VueRouter)和VueRouter构造函数得到的一个实例对象，包含了所有路由包含了许多关键的对象和属性
route： 是一个跳转路由的局部对象，每个路由都会有一个route对象，可以获取对应的name、path、params、query等
以上在vue2.x与vue3.x中是一致的，要注意区分。
.
在vue3.x setup中 ， useRouter、useRoute通常用来：
- useRouter：进行路由跳转
- useRoute：获取路由参数
<script setup>
import { useRoute, useRouter } from 'vue-router'
const router = useRouter();
const route = useRoute();
console.log(route); // 获取路由参数
router.push('/logo'); // 进行路由跳转
</script>
vue-router 3.x中 获取路由参数：
-
在组件中：
{{$route.query.color}}或{{$route.params.color}} -
在 JS 中：
this.$route.query.color或this.$route.params.color
路由（导航）守卫
路由守卫简单来讲就是监听页面进入，修改，和离开的功能。
每个守卫接受三个参数：
- to：即将要进入的路由对象
- from：当前导航正要离开的路由
- next：一定要调用该方法来 resolve 这个钩子。执行效果依赖 next 方法的调用参数。
关于 next ：
next()：进行管道中的下一个钩子。如果全部钩子执行完了，则导航的状态就是 confirmed （确认的）。next(false)：中断当前的导航。如果浏览器的 URL 改变了（可能是用户手动或浏览器后退按钮），那么 URL 地址会重置到 from 路由对应的地址。next('/')或next({ path: '/' })：跳转到一个不同的地址。当前的导航被中断，然后进行一个新的导航。next(error)：(2.4.0+) 如果传入 next 的参数是一个 Error 实例，则导航会被终止且该错误会被传递给 router.onError() 注册过的回调。
vue-router 3.x中：
<script type="text/ecmascript-6">
export default {
beforeRouteEnter(to, from, next){
// 在渲染该组件的对应路由被confirm前调用
// 此时组件实例还没被创建，因此不能获取`this`
}
beforeRouteUpdate(to, from, next){
// 在当前路由改变，但该组件被复用时调用
// 举例：对于一个带有动态参数的路径`/item/:id`,在`/item/1`和`/item/2`之间跳转的时候，
// 由于会渲染相同的`Item`组件，因此组件实例会被复用，从而触发这个钩子
// 此时可以获取到`this`
}
beforeRouteLeave(to, from, next){
// 导航离开该组件的对应路由时调用
// 时可以获取到`this`
}
}
};
</script>
vue-router 4.x中：
| vue-router 3.x | vue-router 4.x |
|---|---|
| beforeRouteEnter | 无 |
| beforeRouteUpdate | onBeforeRouteUpdate |
| beforeRouteLeave | onBeforeRouteLeave |
在setup中，由于路由已经发生了，因此在setup内部设置beforeRouteEnter没有任何意义，因此并无onBeforeRouteEnter
<script>
import { onBeforeRouteLeave, onBeforeRouteUpdate } from 'vue-router';
export default {
setup() {
onBeforeRouteLeave((to, from) => {
alert('你真的想离开吗？您有未保存的更改！');
});
onBeforeRouteUpdate(async (to, from) => {
if (to.params.id !== from.params.id) {
// ...
}
});
}
};
</script>
动态路由
动态路由参数 id：
<!-- 导航页 -->
<template>
<router-link :to="'/news/' + newsId">新闻详情</router-link>
</template>
<script setup>
import { ref } from 'vue';
const newsId = ref('001');
</script>
获取路由参数：
<!-- 新闻详情页 -->
<template>
<div id="news">
<p>id:{{$route.params.id}}</p>
<p>{{newsId}}</p>
</div>
</template>
<script setup>
import {useRoute} from 'vue-router';
import {computed} from 'vue';
const route=useRoute();
const newsId=computed(()=>{
return route.params.id
})
</script>
路由懒加载
//router/index.js
import Home from '../component/Home.vue'
import Mine from '../component/Mine.vue'
import News from '../component/News.vue'
const routes = [
{ path: "/", redirect: "/home" },
{ path: "/home", component: Home },
{ path: "/mine", component: Mine },
{ path: "/news/:id", component: News },
];
改为懒加载：
const routes = [
{ path: "/", redirect: "/home" },
{ path: "/home", component: () => import("@/views/Home.vue") },
{ path: "/mine", component: () => import("@/views/Mine.vue") },
{ path: "/news/:id", component: () => import("@/views/News.vue") }
]
keep-alive
可利用keep-alive的 include 或 exclude 属性（include 和 exclude 包含的name 是组件的name不是router name）来设置缓存：
include值为字符串或者正则表达式匹配的组件name会被缓存。exclude值为字符串或正则表达式匹配的组件name不会被缓存。
vue2.x写法：
<keep-alive exclude="Home"> // 缓存除了Home外的所有组件
<router-view></router-view>
</keep-alive>
vue3.x写法：
<template>
<router-view v-slot="{ Component }">
<keep-alive :include="includeList">
<component :is="Component" />
</keep-alive>
</router-view>
</template>
<script setup>
import { ref } from 'vue';
// 需要缓存的组件name值
const includeList = ref(['About', 'User']); // 缓存About和User组件
</script>
也可以在router.js中添加meta属性动态判断：
meta: { title: '缓存页面', keepAlive: true }
import { watch } from 'vue'
import {useRouter} from 'vue-router'
const router =useRouter()
const includeList = [];
watch(() => router.currentRoute.value,(val) => {
// 只要设置了keepAlive属性的，全部加入缓存列表中
if (val.meta.keepAlive && keepAliveList.indexOf(val.name) === -1) {
includeList.push(val.name);
}
},{immediate: true,deep: true})
