共计 5291 个字符,预计需要花费 14 分钟才能阅读完成。
前言
Vue Router 是 Vue.js 官网的路由管理器。
它和 Vue.js 的外围深度集成,让构建单页面利用变得大海捞针。
蕴含的性能有:
- 嵌套的路由 / 视图表
- 模块化的、基于组件的路由配置
- 路由参数、查问、通配符
- 基于 Vue.js 过渡零碎的视图过渡成果
- 细粒度的导航管制
- 带有主动激活的 CSS class 的链接
- HTML5 历史模式或 hash 模式,在 IE9 中主动降级
- 自定义的滚动条行为
本文是作者是理论我的项目中遇到的一些总结,次要包含:
响应路由参数变动
路由匹配
高级匹配模式
匹配优先级
push 和 replace 的第二个第三个参数
路由视图
重定向
应用 props 解耦 $route
导航守卫
守卫的 next 办法
心愿本文对你有所帮忙。
注释
1. 响应路由参数变动
针对复用组件(只是路由参数产生扭转),生命周期函数钩子不会被调用,如何能刷新组件了?
-
watch 监听
watch: {'$route' (to, from) {// 对路由变动作出响应...} }
-
beforeRouteUpdate
beforeRouteUpdate (to, from, next) { // react to route changes... / / don't forget to call next()}
2. 路由匹配
{ // 会匹配所有门路 path: '*' } { // 会匹配以 `/user-` 结尾的任意门路 path: '/user-*' }
留神:当应用通配符路由时,请确保路由的程序是正确的,也就是说含有通配符的路由应该放在最初。路由 {path: ‘*’} 通常用于客户端 404 谬误。
如果你应用了 History 模式,请确保正确配置你的服务器。
当应用一个通配符时,$route.params 内会主动增加一个名为 pathMatch 参数。
它蕴含了 URL 通过通配符被匹配的局部:
// 给出一个路由 {path: '/user-*'}
this.$router.push('/user-admin')
this.$route.params.pathMatch // 'admin'
// 给出一个路由 {path: '*'}
this.$router.push('/non-existing')
this.$route.params.pathMatch // '/non-existing'
3. 高级匹配模式
// 命名参数必须有 "单个字符"[A-Za-z09] 组成
// ? 可选参数
{path: '/optional-params/:foo?'}
// 路由跳转是能够设置或者不设置 foo 参数,可选
<router-link to="/optional-params">/optional-params</router-link>
<router-link to="/optional-params/foo">/optional-params/foo</router-link>
// 零个或多个参数
{path: '/optional-params/*'}
<router-link to="/number"> 没有参数 </router-link>
<router-link to="/number/foo000"> 一个参数 </router-link>
<router-link to="/number/foo111/fff222"> 多个参数 </router-link>
// 一个或多个参数
{path: '/optional-params/:foo+'}
<router-link to="/number/foo"> 一个参数 </router-link>
<router-link to="/number/foo/foo111/fff222"> 多个参数 </router-link>
// 自定义匹配参数
// 能够为所有参数提供一个自定义的 regexp,它将笼罩默认值([^\/]+){path: '/optional-params/:id(\\d+)' }
{path: '/optional-params/(foo/)?bar' }
4. 匹配优先级
有时候一个门路可能匹配多个路由。
此时,匹配的优先级就是依照路由的定义程序:先定义,优先级最高。
5. push 和 replace 的第二个第三个参数
在 2.2.0+ 版本,可选的在 router.push 或 router.replace 中提供 onComplete 和 onAbort 回调作为第二个和第三个参数。
这些回调将会在导航胜利实现 (在所有的异步钩子被解析之后) 或终止 (导航到雷同的路由、或在以后导航实现之前导航到另一个不同的路由) 的时候进行相应的调用。在 3.1.0+,能够省略第二个和第三个参数,此时如果反对 Promise,router.push 或 router.replace 将返回一个 Promise。
接下来看几个例子来看看第二个第三个参数的调用机会:
1. 组件 1 跳转组件 2
// 组件 1
this.$router.push({name: 'number'}, () => {console.log('组件 1:onComplete 回调');
}, () => {console.log('组件 1:onAbort 回调');
});
// 组件 2
beforeRouteEnter(to, from, next) {console.log('组件 2:beforeRouteEnter');
next();},
beforeCreate() {console.log('组件 2:beforeCreate');
},
created() {console.log('组件 2:created');
}
组件之间跳转触发 onComplete 回调。
2. 组件 2 跳转组件 2(不带参数)
this.$router.push({name: 'number'}, () => {console.log('组件 2:onComplete 回调');
}, () => {console.log('组件 2, 自我跳转:onAbort 回调');
});
组件自我跳转当不带参数时触发 onAbort 回调。然而当自我跳转带参数时可能状况就有点不一样。
3. 组件 2 跳转组件 2(带参数)
this.$router.push({name: 'number', params: { foo: this.number}}, () => {console.log('组件 2:onComplete 回调');
}, () => {console.log('组件 2, 自我跳转:onAbort 回调');
});
组件自我带参数跳转,onComplete 回调、onAbort 回调回调都不会触发。
6. 路由视图
有时候想同时 (同级) 展现多个视图,而不是嵌套展现,例如创立一个布局,有 sidebar (侧导航) 和 main (主内容) 两个视图,这个时候命名视图就派上用场了。
你能够在界面中领有多个独自命名的视图,而不是只有一个独自的进口。
如果 router-view 没有设置名字,那么默认为 default。
<router-view class="view one"></router-view>
<router-view class="view two" name="a"></router-view>
<router-view class="view three" name="b"></router-view>
一个视图应用一个组件渲染,因而对于同个路由,多个视图就须要多个组件。
确保正确应用 components 配置 (带上 s):
const router = new VueRouter({
routes: [
{
path: '/',
components: {
default: Foo,
a: Bar,
b: Baz
}
}
]
});
7. 重定向
{path: '/a', redirect: '/b'}
{path: '/a', redirect: { name: 'foo'}}
{ path: '/a', redirect: to => {
// 办法接管 指标路由 作为参数
// return 重定向的 字符串门路 / 门路对象
}}
留神:导航守卫并没有利用在跳转路由上,而仅仅利用在其指标上。
在下面这个例子中,为 /a 路由增加一个 beforeEach 或 beforeLeave 守卫并不会有任何成果。
8. 应用 props 解耦 $route
在组件中应用 $route 会使之与其对应路由造成高度耦合,从而使组件只能在某些特定的 URL 上应用,限度了其灵活性。
// router 文件
// 对于蕴含命名视图的路由,你必须别离为每个命名视图增加 `props` 选项:{
path: '/number/:name',
props: true,
// 对象模式 props: {newsletterPopup: false}
// 函数模式 props: (route) => ({query: route.parmas.name})
name: 'number',
component: () => import( /* webpackChunkName: "number" */ './views/Number.vue')
}
// 组件获取
export default{props: ['name']
}
9. 导航守卫
1. 三种全局守卫
- router.beforeEach 全局前置守卫 进入路由之前。
- router.beforeResolve 全局解析守卫 2.5.0 新增。在 beforeRouteEnter 调用之后调用。
-
router.afterEach 全局后置钩子 进入路由之后。
// 入口文件 import router from './router' // 全局前置守卫 router.beforeEach((to, from, next) => {console.log('beforeEach 全局前置守卫'); next();}); // 全局解析守卫 router.beforeResolve((to, from, next) => {console.log('beforeResolve 全局解析守卫'); next();}); // 全局后置守卫 router.afterEach((to, from) => {console.log('afterEach 全局后置守卫'); });
2. 路由独享守卫
-
beforeEnter 全局前置守卫进入路由之前。
{ path: '/number/:name', props: true, name: 'number', // 路由独享守卫 beforeEnter: (to, from, next) => {console.log('beforeEnter 路由独享守卫'); next();}, component: () => import( /* webpackChunkName: "number" */ './views/Number.vue') }
3. 组件内守卫
- beforeRouteEnter
- beforeRouteUpdate(2.2 新增)
-
beforeRouteLeave
beforeRouteEnter(to, from, next) { // 在渲染该组件的对应路由被 confirm 前调用 // 不!能!获取组件实例 `this` // 因为当守卫执行前,组件实例还没被创立 console.log('beforeRouteEnter 组件内进入守卫'); next();}, beforeRouteUpdate(to, from, next) { // 在以后路由扭转,然而该组件被复用时调用 // 举例来说,对于一个带有动静参数的门路 /foo/:id,在 /foo/1 和 /foo/2 之间跳转的时候,// 因为会渲染同样的 Foo 组件,因而组件实例会被复用。而这个钩子就会在这个状况下被调用。// 能够拜访组件实例 `this` console.log('beforeRouteUpdate 组件内更新守卫'); next();}, beforeRouteLeave(to, from, next) { // 导航来到该组件的对应路由时调用 // 能够拜访组件实例 `this` console.log('beforeRouteLeave 组件内来到守卫'); next();}
- 组件 1 跳转到组件 2,而后组件 2 跳转组件 2 自身
- 组件 1 跳转到组件 2,而后组件 2 跳转组件 1
10. 守卫的 next 办法
next: 调用该办法 resolve 钩子。
- next(): 进行管道中的下一个钩子。如果全副钩子执行完了,则导航的状态就是 confirmed ( 确认的)。
- next(false): 中断以后的导航。如果浏览器的 URL 扭转了 (可能是用户手动或者浏览器后退按钮),那么 URL 地址会重置到 from 路由对应的地址。
- next(‘/’) 或者 next({path: ‘/’}): 跳转到一个不同的地址。以后的导航被中断,而后进行一个新的导航。你能够向 next 传递任意地位对象,且容许设置诸如 replace: true、name: ‘home’ 之类的选项以及任何用在 router-link 的 to prop 或 router.push 中的选项。
- next(error): (2.4.0+) 如果传入 next 的参数是一个 Error 实例,则导航会被终止且该谬误会被传递给 router.onError() 注册过的回调。
最初
最终还是心愿大家多看看文档,了解了再去应用到我的项目中,不至于应用之后呈现 bug,谢谢。
如果感觉内容有帮忙,能够关注下我的公众号,把握最新动静,一起学习!