Vue Router 是Vue.js的官方路由:
- 它与Vue.js核心深度集成,让用Vue.js构成
单页面应用(SPA)
变得非常容易
Vue Router 是基于路由和组件的
- 路由用于设定
访问路径
,将路径和组件映射
起来 - 在vue-router的单页面应用中,页面的路径的改变就是组件的切换
安装Vue Router
npm install vue-router
路由的使用步骤
- 创建路由需要的映射的组件 (打算显示的页面)
- 通过
createRouter
创建路由对象,并传入routes
和history
模式;- 配置路由映射:组件和路径映射关系的routes数组
- 创建基于hash或者history的模式
- 使用App注册路由对象(use方法)
- 通过使用: 通过
<router-link>和<router-view>
默认的路由路径
- 默认没有显示首页组件,必须让用户点击才可以,如何让路径默认跳到首页,并且渲染首页组件呢?
const routes = [
{ path: "/", redirect: '/home},
{ path: "/home", component: Home},
{ path: "/about, component: About}
]
- 在routes中配置了一个映射
- path配置的是
根路径: /
- redirect是重定向,将根路径重定向到/home路径下,这样就可得到想要的结果
- path配置的是
router-linke
- router-linke 属性配置
- to 属性: 是一个字符串,或者是一个对象
- replace 属性: 设置replace 属性的话,当点击时,会调用router.replace(), 而不是router.push();
- active-class 属性: 设置激活a元素后应用的class,默认是router-link-active
- exact-active-class属性:链接精准激活时,应用于渲染的class, 默认是router-link-exact-active
路由懒加载
- 当打包构建应用时,JavaScript 包会变得非常大,影响页面加载:
- 如果能把不同路由对应的组件分割成不同的代码块,然后当路由被访问的时候才加载对应组件,这样会更加高效
- 也可以提高首屏的渲染效率
- 如果能把不同路由对应的组件分割成不同的代码块,然后当路由被访问的时候才加载对应组件,这样会更加高效
- Vue Router 默认就支持动态来导入组件:
- component 可以传入一个组件,也可以接收一个函数,该函数 需要返回一个Promise;
- 而 import 函数就是返回一个Promise;
路由的其他属性
- name属性: 路由记录独一无二的名称
- meta属性:自定义的数据
动态路由的基本匹配
- 很多时候我们需要将给定匹配模式的路由映射到同一个组件:
- 例如,我们可能有一个User组件,它应对所有用户进行渲染,但是用户的ID是不同的;
- 在Vue Router中,我们可以在路径中使用一个动态字段来实现,我们称之为 路径参数;
{ path: '/user/:id', component: () => import('../view/User.vue') }
- 在router-link中进行如下跳转:
<router-link to="/user/123">用户:123</router-link>
获取动态路由的值
- 在User中如何获取到对应的值呢?
- 在template中,直接通过$route.params获取值
- 在setup中,我们要使用vue-router库给我们提供一个hook useRoute
该Hook会防护一个Route对象, 对象中保存着当前路由相关的值
<template>
<div>
<h2>用户界面:: {{ $route.params.id }}</h2>
</div>
</template>
export default {
create() {
console.log(this.$route.params.id)
},
setup () {
const route = useRoute()
console.log(route)
console.log(route.params.id)
}
NotFound
- 对于那些没有匹配到的的路由,我们通常会匹配到固定的某个页面
- 比如NotFound的错误页面中,这个时候我们可编写一个动态路由用于匹配所有的页面
{ path: '/:pathMatch(.*)', component: () => import('../pages/NotFound.vue') }
- 可以通过$route.params.pathMatch获取到传入的参数:
Not Found: user/hahah/123
<h2>Not Found: {{ $route.params.pathMatch }}</h2>
匹配规则加*
- 这里还有另外一种写法
{ path: '/:pathMatch(.*)*', component: () => import('../pages/NotFound.vue') }
- 它们的区别在于解析的时候,是否解析 /:
- Not Found:["user","hahah", "123"]
path: '/:pathMatch(.*)*',
- Not Found: user/hahah/123
path:'/:pathMatch(.*)',
- Not Found:["user","hahah", "123"]
路由的嵌套
- 什么是路由的嵌套呢?
- 路由的嵌套,也可以称为“父子路由”,即在一个路由中又包含了另一个路由。
路由嵌套的配置
{
path: '/home',
component: () => import('../pages/Home.vue'),
children: [
{
path: '',
redirect: '/home/product'
},
{
path: 'product',
component: () => import('../pages/HomeProduct.vue')
},
{
path: 'message',
component: () => import('../pages/HomeMessage.vue')
}
]
}
代码的页面跳转
- 有时候我们希望通过代码来完成页面的跳转,比如点击的是一个按钮
jumpToProfile() { jumpToProfile() { this.$router.push('/profile') } }
- 当然,也可以是传入一个对象
jumpToProfile() { this.$router.push({ path: '/profile' }) }
- 如果是在setup中编写的代码,那么可以通过useRouter 来获取
import { useRouter } from 'vue-router' const router = useRouter() const jumpToProfile = () => { router.replace('/profile') }
动态添加路由
- 某些情况下可能需要动态的来添加路由:
- 比如根据用户不同的权限,注册不同的路由
- 这个·时候我们可以使用一个方法addRoute
- 如果我们是为route添加一个children路由,那么可以传入对应的name
const addRouteOne = {
path:'/addone'
component: () => import('../pages/AddOne')
}
router.addRoute(addRouteOne)
const addRouteOne = {
path:'/addone'
component: () => import('../pages/AddOne')
}
router.addRoute('home', addRouteOne)
- 路由其他方法补充
- router.hasRoute():检查路由是否存在
- router.getRoutes(): 获取一个包含所有路由记录的数组
路由导航守卫
- next.router.vuejs.org/zh/guide/ad…
- vue-router提供的导航守卫主要用来通过
跳转或取消的方式守卫导航
- 全局的前置守卫beforeEach是在导航触发时会被回调的
- 它有两个参数:
to
: 即将进入的路由Route对象from
: 即将离开的路由Route对象
- 它有返回值
- false: 取消当前导航;
- 不返回或者
undefined
:进行默认导航 返回一个路由地址
:- 可以是一个string类型的路径
- 可以是一个对象,对象包含path、query、params等信息
- 可选的第三个参数:next(不推荐使用)
- 在Vue2中对我们是通过next函数来决定如何进行跳转的
- 但是在Vue3中我们是通过放回值来控制的,不再推荐使用next函数,这是因为开发中很多容易调用多次next;
登录守卫功能
- 只有登录后才能看到其他页面
router.beforeEach((to, from) => {
if(to.path !== '/login') {
const token = window.localStorage.getItem('token')
if (!token) {
return {
path: '/login'
}
}
}
})
export default {
setup() {
const router = useRouter()
const login = () => {
window.localStorage.setItem('token', '123')
router.push({
path: '/home'
})
}
return {
login
}
}
}