Vue-router 学习笔记
学习目的
学习Vue的必备技能,必须 熟练使用 Vue-router,能够在实际项目中运用。
Vue-router介绍
Vue Router 是 Vue.js 官方的路由管理器。它和 Vue.js 的核心深度集成,让构建单页面应用变得易如反掌。包含的功能有:嵌套的路由/视图表;模块化的、基于组件的路由配置;路由参数、查询、通配符;基于 Vue.js 过渡系统的视图过渡效果;细粒度的导航控制;带有自动激活的 CSS class 的链接;HTML5 历史模式或 hash 模式,在 IE9 中自动降级;自定义的滚动条行为。
由 前端 来控制页面的跳转(但其实是个单页面),根据不同的 url 地址展示不同的内容和页面。
优点:体验好,不需要每次从服务器获取全部,快速展现给用户;
缺点:不利于SEO;使用浏览器的前进,后退键的时候会重新发送请求,没有合理的利用缓存;单页面午饭记住之前滚动的位置,无法在前进和后退的时候记住滚动的位置。
Vue-router安装
安装 npm install vue-router --save-dev
src 目录下 新建 router 目录,目录下新建 index.js
index.js 引入vue-router在 main.js中引入
实例中使用routerVue-router 核心
路由跳转的方式
<router-link to=' '></router-link> 和 this.$router.push({path:' '})
路由跳转 路由设置动态路由匹配
动态路由路径参数,以冒号开头,如上图的 ↑↑↑↑↑↑↑↑↑↑↑↑↑↑
获取路由的参数
获取动态路由的参数当在路由中设置了 props:true 的时候
路由中设置 直接当做props中的属性使用官方文档中的说明
官方文档中的说明响应路由参数的变化
当路由参数发生变化时,比如helloworld/123 导航到 helloworld/456,原来的组件实例会被复用。因为两个路由都渲染同个组件,比起销毁再创建,复用则显得更加高效。不过,这也意味着组件的生命周期钩子不会再被调用。
复用组件时,想对路由参数的变化作出响应的话,可以用以下两种方式
比如 mounted ,created 不会再被调用 , 以上 两种方式 监听参数变化,作出相应的业务逻辑处理。
嵌套路由
当你访问 /layout 时,layout 的 router-view 是不会渲染任何东西,这是因为没有匹配到合适的子路由。如果你想要渲染点什么,可以提供一个 空的 子路由(可以理解为默认输出):
空子路由 编程式的导航
除了使用 创建 a 标签来定义导航链接,我们还可以借助 router 的实例方法,通过编写代码来实现: this.$router.push({path:' '})
文档示例:
router.push('home') ;// 字符串
router.push({path:'home'}); // 对象
router.push({name:'user',params:{userId:123}}); // 命名的路由
router.push({path:'register',query:{plan:'private'}});// 带查询参数,变成 /register?plan=private ,获取 this.$route.query. plan
注意:如果提供了 path,params 会被忽略,上述例子中的 query 并不属于这种情况。取而代之的是下面例子的做法,你需要提供路由的 name 或手写完整的带有参数的 path:
const userId = 123
router.push({ name: 'user', params: { userId }}); // -> /user/123
router.push({ path: `/user/${userId}` }) ; // -> /user/123
// 这里的 params 不生效(注意这个例子)
router.push({ path: '/user', params: { userId }}) ; // -> /user
同样的规则也适用于 router-link 组件的 to 属性。
以上规则同样适用于router-link router.go(n) 这个方法的参数是一个整数,意思是在 history 记录中向前或者后退多少步,类似 window.history.go(n)。
router.go(1) ; // 在浏览器记录中前进一步,等同于 history.forward( )
router.go(-1); // 后退一步记录,等同于 history.back( )
router.go(3); // 前进 3 步记录
命名路由 和 命名视图
命名路由
这跟代码调用 router.push() 是一样的:
this.$router.push({ name:'Helloworld',params:{id:123}});
命名视图
有时候想同时 (同级) 展示多个视图,而不是嵌套展示,例如创建一个布局,有 sidebar (侧导航) 和 main (主内容) 两个视图,这个时候命名视图就派上用场了。你可以在界面中拥有多个单独命名的视图,而不是只有一个单独的出口。如果 router-view 没有设置名字,那么默认为 default。
文档示例
嵌套命名视图
嵌套命名视图 路由配置 显示效果重定向 和 别名
重定向
重定向 通过 routes 配置来完成
redirect 别名 (文档示例)
/a 的别名是 /b,意味着,当用户访问 /b 时,URL 会保持为 /b,但是路由匹配则为 /a,就像用户访问 /a 一样
const router = new VueRouter({
routes: [
{ path: '/a', component: A, alias: '/b' }
]})
导航守卫
“导航”表示 路由正在发生改变。 vue-router 提供的导航守卫主要用来通过跳转或取消的方式守卫导航。有多种机会植入路由导航过程中:全局的, 单个路由独享的, 或者组件级的。
记住参数或查询的改变并不会触发进入/离开的导航守卫。你可以通过观察 $route 对象来应对这些变化,或使用 beforeRouteUpdate 的组件内守卫。
个人的理解,导航守卫有点类似 中间件,进入 路由 前 先通过守卫,来判断是否可以通过,进而到达页面。
全局守卫 (在定义router的 地方定义)
全局守卫
全局前置守卫 router.beforeEach
每个守卫方法接收三个参数:
to: Route: 即将要进入的目标 路由对象
from: Route: 当前导航正要离开的路由
next: Function: 一定要调用该方法来 resolve 这个钩子。执行效果依赖 next 方法的调用参数。
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() 注册过的回调。
确保要调用 next 方法,否则钩子就不会被 resolved。
全局解析守卫 router.beforeResolve
跟 全局前置守卫 一样,接收三个参数
这和 router.beforeEach 类似,区别是在导航被确认之前,同时在所有组件内守卫和异步路由组件被解析之后,解析守卫就被调用。
确保要调用 next 方法
全局后置钩子 router.afterEach
不会接受 next 函数也不会改变导航本身
路由独享的守卫(在路由内定义)
路由内的守卫
这些守卫与全局前置守卫的方法参数是一样的。
组件内的守卫(在组件内定义)
组件内的守卫 beforeRouteEnter 守卫 不能 访问 this,因为守卫在导航确认前被调用,因此即将登场的新组件还没被创建。不过,你可以通过传一个回调给 next来访问组件实例。在导航被确认的时候执行回调,并且把组件实例作为回调方法的参数。
beforeRouteEnter(to,from,next){
next( vm => {
// 通过 `vm` 访问组件实例
})}
注意 beforeRouteEnter 是支持给 next 传递回调的唯一守卫。对于 beforeRouteUpdate 和 beforeRouteLeave 来说,this 已经可用了,所以不支持传递回调,因为没有必要了。
beforeRouteUpdate(to,from,next){
// just use `this`
this.name = to.params.name;
next();
}
这个离开守卫通常用来 禁止用户在还未保存修改前突然离开 。该导航可以通过 next(false) 来取消。
beforeRouteLeave(to,from,next){
const answer = window.confirm('Do you really want to leave? you have unsaved changes!');
if(answer){
next();
}else{
next(false);
}}
完整的导航解析流程
导航被触发。
在失活的组件里调用离开守卫。
调用全局的 beforeEach 守卫。
在重用的组件里调用 beforeRouteUpdate 守卫 (2.2+)。
在路由配置里调用 beforeEnter。
解析异步路由组件。
在被激活的组件里调用 beforeRouteEnter。
调用全局的 beforeResolve 守卫 (2.5+)。
导航被确认。
调用全局的 afterEach 钩子。
触发 DOM 更新。
用创建好的实例调用 beforeRouteEnter 守卫中传给 next 的回调函数。
过渡动效
<router-view>是基本的动态组件,所以我们可以用 <transition>组件给它添加一些过渡效果:
transition 在组件内写动画效果fade-enter:进入过渡的开始状态,元素被插入时生效,只应用一帧后立刻删除。
fade-enter-active:进入过渡的结束状态,元素被插入时就生效,在过渡过程完成后移除。
fade-leave:离开过渡的开始状态,元素被删除时触发,只应用一帧后立刻删除。
fade-leave-active:离开过渡的结束状态,元素被删除时生效,离开过渡完成后被删除。
数据获取(以下为 文档示例 )
有时候,进入某个路由后,需要从服务器获取数据。例如,在渲染用户信息时,你需要从服务器获取用户的数据。我们可以通过两种方式来实现:
导航完成之后获取:先完成导航,然后在接下来的组件生命周期钩子中获取数据。在数据获取期间显示“加载中”之类的指示。
导航完成之前获取:导航完成前,在路由进入的守卫中获取数据,在数据获取成功后执行导航。
从技术角度讲,两种方式都不错 —— 就看你想要的用户体验是哪种。
导航完成后获取数据
当你使用这种方式时,我们会马上导航和渲染组件,然后在组件的 created 钩子中获取数据。这让我们有机会在数据获取期间展示一个 loading 状态,还可以在不同视图间展示不同的 loading 状态。
假设我们有一个 Post 组件,需要基于 $route.params.id 获取文章数据:
官方文档示例在导航完成前获取数据
通过这种方式,我们在导航转入新的路由前获取数据。我们可以在接下来的组件的 beforeRouteEnter守卫中获取数据,当数据获取成功后只调用 next 方法。
官方文档示例