Vue Router深入学习(二)


Vue Router 深入学习(二)

通过阅读文档,自己写一些 demo 来加深自己的理解。(主要针对 Vue3)
上一篇:Vue Router 深入学习(一)

1. 路由元信息

有时,你可能希望将任意信息附加到路由上,如过渡名称、谁可以访问路由等。这些事情可以通过接收属性对象的meta属性来实现,并且它可以在路由地址和导航守卫上都被访问到。定义路由的时候你可以这样配置 meta 字段

语法:

1
2
3
4
5
6
7
8
9
10
const routes = [
{
path: "/user",
component: () => import("../components/User.vue"),
meta: {
tag: "用户",
isLogin: true,
},
},
];

1.1 简单使用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
import { createRouter, createWebHistory } from "vue-router";

const routes = [
{
path: "/user",
component: () => import("../components/User.vue"),
meta: {
tag: "用户",
isLogin: true,
},
},
];

export default new createRouter({
history: createWebHistory(),
routes,
});
1
2
3
4
5
6
7
8
9
10
11
12
13
<template>
<h2>User</h2>
<p>{{ route.meta }}</p>
</template>

<script setup>
import { useRoute } from "vue-router";

const route = useRoute();
console.log(route.meta);
</script>

<style></style>

image-20220304103855475

1.2 搭配路由守卫使用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
import { createRouter, createWebHistory } from "vue-router";

const routes = [
{
path: "/user",
component: () => import("../components/User.vue"),
meta: {
tag: "用户",
isLogin: true,
},
children: [
{
path: ":id(\\d+)",
component: () => import("../components/UserId.vue"),
meta: {
type: "id",
requireAuth: true,
},
},
{
path: ":name",
component: () => import("../components/UserName.vue"),
meta: {
type: "name",
requireAuth: false,
},
},
],
},
];

export default new createRouter({
history: createWebHistory(),
routes,
});

路由前置守卫

1
2
3
4
5
6
7
8
9
10
router.beforeEach((to, from) => {
if (to.meta.requireAuth) {
return {
path: "/user",
query: {
redirect: to.path, // 保存要去的位置,获得权限后再去
},
};
}
});

vue-router

2. 数据获取

有时候,进入某个路由后,需要从服务器获取数据。例如,在渲染用户信息时,你需要从服务器获取用户的数据。

2.1 导航完成后获取数据

当你使用这种方式时,我们会马上导航和渲染组件,然后在组件的 created 钩子中获取数据。这让我们有机会在数据获取期间展示一个 loading 状态,还可以在不同视图间展示不同的 loading 状态。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
<template>
<div class="content">
<p>id: {{ post.id }}</p>
</div>
<span>
<router-link :to="{ name: 'Post', params: { id: 222 } }">222</router-link>
</span>
<span>
<router-link :to="{ name: 'Post', params: { id: 333 } }">333</router-link>
</span>
<span>
<router-link :to="{ name: 'Post', params: { id: 444 } }">444</router-link>
</span>
</template>

<script setup>
import { reactive, watchEffect } from "vue";
import { useRoute } from "vue-router";

let post = reactive({
id: null,
});
const route = useRoute();

const fetchData = () => {
// 数据获取,不需要生命周期钩子。因为beforeCreate和created没有API,因为setup实际上就相当于这两个生命周期函数
post.id = route.params.id;
};

watchEffect(() => {
const id = post.id;
fetchData();
});
</script>

<style scoped>
span {
margin: 0 5px;
}
</style>

vue-router

2.2 在导航完成前获取数据

通过这种方式,我们在导航转入新的路由前获取数据。我们可以在接下来的组件的 beforeRouteEnter 守卫中获取数据,当数据获取成功后只调用 next 方法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
<template>
<div class="content">
<p>id: {{ post.id }}</p>
</div>
<span>
<router-link :to="{ name: 'Post', params: { id: 222 } }">222</router-link>
</span>
<span>
<router-link :to="{ name: 'Post', params: { id: 333 } }">333</router-link>
</span>
<span>
<router-link :to="{ name: 'Post', params: { id: 444 } }">444</router-link>
</span>
</template>

<script>
export default {
data() {
return {
post: {},
};
},
beforeRouteEnter(to, from, next) {
// 不要写在setup里
next((vm) => {
vm.setData(to.params);
});
},
beforeRouteUpdate(to, from) {
this.post = to.params;
},
methods: {
setData(post) {
this.post = post;
},
},
};
</script>

<style scoped>
span {
margin: 0 5px;
}
</style>

效果和上图一样。这里有点问题,通过beforeRouteEnter无法获取到 setup里的函数、数据等,所以变成了使用 Vue2 的形式来实现。

3. 过渡动效

3.1 transition 简单了解

<Transition> 会在一个元素或组件进入和离开 DOM 时应用动画

image-20220304182013408

3.2 简单使用

1
2
3
4
5
<router-view v-slot="{ Component }">
<transition name="fade">
<component :is="Component"></component>
</transition>
</router-view>

在 router-view 上使用 v-slot 获取对应的组件,使用 component 动态组件来渲染这个组件,然后用 transition 包裹住这个动态组件

对应的路由组件只能有一个根元素,否则过渡将没有效果

1
2
3
4
5
6
7
8
9
.fade-enter-from,
.fade-leave-to {
transform: translateX(-100px);
opacity: 0;
}

.fade-enter-active {
transition: all 1s;
}

效果:

vue-router

代码部分

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
<template>
<router-view v-slot="{ Component }">
<transition name="fade">
<component :is="Component"></component>
</transition>
</router-view>
</template>

<script setup></script>

<style>
.fade-enter-from,
.fade-leave-to {
transform: translateX(-100px);
opacity: 0;
}

.fade-enter-active {
transition: all 1s;
}
</style>

3.3 单个路由的过渡

原理很简单,路由配置时在meta上添加上trasition属性,再动态地和 name结合在一起就行

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
const routes = [
{
path: "/",
component: () => import("../components/Home.vue"),
},
{
path: "/post",
name: "Post",
component: () => import("../components/Post.vue"),
meta: {
transition: "slide-left",
},
},
{
path: "/user",
name: "User",
component: () => import("../components/User.vue"),
meta: {
transition: "slide-right",
},
},
];
1
2
3
4
5
<router-view v-slot="{ Component, route }">
<transition :name="route.meta.transition || fade">
<component :is="Component"></component>
</transition>
</router-view>

再添加上对应的 css 样式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
.fade-enter-from,
.fade-leave-to {
opacity: 0;
}

.fade-enter-active,
.slide-left-enter-active,
.slide-right-enter-active {
transition: all 1s;
}

.slide-left-enter-from,
.slide-left-leave-to {
transform: translateX(-200px);
}

.slide-right-enter-from,
.slide-right-leave-to {
transform: translateX(200px);
}

3.4 基于路由的动态过渡

根据目标路由和当前路由之间的关系,动态地确定使用的过渡

如:添加一个 全局后置钩子,根据路径的深度动态添加信息到 meta 字段

1
2
3
4
5
6
router.afterEach((to, from) => {
const toDepth = to.path.split("/").length;
const fromDepth = from.path.split("/").length;

to.meta.transition = toDepth < fromDepth ? "slide-right" : "slide-left";
});

vue-router

4. 滚动行为

在创建 Router 示例时,提供一个 scrollBehavior方法

1
2
3
4
5
6
7
const router = createRouter({
history: createWebHashHistory(),
routes: [...],
scrollBehavior (to, from, savedPosition) {
// return 期望滚动到哪个的位置
}
})

4.1 普通用法

1
2
3
4
5
6
7
8
9
const router = new createRouter({
history: createWebHistory(),
routes,
scrollBehavior(to, from, savedPosition) {
return {
top: 50, // 始终滚动到距离顶部50px处
};
},
});

vue-router1

如果浏览器支持滚动行为,可以通过behavior变得更流畅

1
2
3
4
5
6
7
8
9
10
const router = new createRouter({
history: createWebHistory(),
routes,
scrollBehavior(to, from, savedPosition) {
return {
top: 50, // 始终滚动到距离顶部50px处
behavior: "smooth",
};
},
});

vue-router1

4.2 通过 el实现相对元素的偏移

el可接受一个 CSS 选择器或一个 DOM 元素

1
2
3
4
5
6
7
8
9
10
const router = new createRouter({
history: createWebHistory(),
routes,
scrollBehavior(to, from, savedPosition) {
return {
el: "h2",
top: 50,
};
},
});

vue-router1

4.3 恢复之前的位置

返回 savedPosition,在按下 后退/前进 按钮时,就会恢复之前的位置。像浏览器的原生表现那样

1
2
3
4
5
6
7
8
9
10
11
12
13
14
const router = new createRouter({
history: createWebHistory(),
routes,
scrollBehavior(to, from, savedPosition) {
if (savedPosition) {
// console.log(savedPosition)
return savedPosition;
} else {
return {
top: 0,
};
}
},
});

vue-router1

4.4 延迟滚动

通过返回一个 Promise 来实现。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
const router = new createRouter({
history: createWebHistory(),
routes,
scrollBehavior(to, from, savedPosition) {
return new Promise((resolve, reject) => {
setTimeout(() => {
resolve({
top: 0,
behavior: "smooth",
});
}, 500);
});
},
});

vue-router1

5. 路由懒加载

把不同路由对应的组件分割成不同的代码块,然后当路由被访问的时候才加载对应组件,会更高效

静态导入:

1
2
3
4
5
6
7
8
9
import User from "../components/User.vue";

const routes = [
{
path: "/user",
name: "User",
component: User,
},
];

动态导入:(实际上还省字)

1
2
3
4
5
6
7
8
9
import { createRouter, createWebHistory } from "vue-router";

const routes = [
{
path: "/user",
name: "User",
component: () => import("../components/User.vue"),
},
];

6. 动态路由

6.1 添加路由

路由配置:初始只有一个路由

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
import { createRouter, createWebHistory } from "vue-router";

const routes = [
{
path: "/",
component: () => import("../components/Home.vue"),
},
];

const router = new createRouter({
history: createWebHistory(),
routes,
});

export default router;

在导航守卫处添加新路由:实际上要限制那些页面的权限就可以这样添加,只有满足条件才会动态添加路由

1
2
3
4
5
6
7
router.beforeEach((to, from) => {
router.addRoute({
path: "/user",
name: "User",
component: () => import("./components/User.vue"),
});
});

6.2 删除路由

当路由被删除时,所有的别名和子路由都会被同时删掉

6.2.1 通过添加一个名字冲突的路由

如果添加与现有名称相同的路由,会先删除路由,再添加路由。

1
2
3
router.addRoute({ path: "/about", name: "about", component: About });
// 这将会删除之前已经添加的路由,因为他们具有相同的名字且名字必须是唯一的
router.addRoute({ path: "/other", name: "about", component: Other });

6.2.2 通过调用 router.addRoute() 返回的回调

情境:路由没有名称,没法覆盖删除掉路由

1
2
const removeRoute = router.addRoute(routeRecord);
removeRoute(); // 删除路由如果存在的话

6.2.3 通过使用 router.removeRoute() 按名称删除路由

1
2
3
router.addRoute({ path: "/about", name: "about", component: About });
// 删除路由
router.removeRoute("about");

6.3 添加嵌套路由

1
2
3
4
5
6
router.addRoute({
name: "admin",
path: "/admin",
component: Admin,
children: [{ path: "settings", component: AdminSettings }],
});

也可以将路由的 name作为第一个参数传递给 router.addRoute(),这样就可以有效的添加路由

1
2
router.addRoute({ name: "admin", path: "/admin", component: Admin });
router.addRoute("admin", { path: "settings", component: AdminSettings });

6.4 查看现有路由


文章作者: 赤蓝紫
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 赤蓝紫 !
评论
  目录