vue-router 入门学习

Posted 2020-10-01

对于单页面应用，尤其是移动端的网页应用，使用<a></a>标签实现页面切换和跳转会有300ms的延迟，遇到网速慢就会一直加载。所以在SPA应用中，用视图切换来模拟页面的切换

vue-router 是Vue.js官方的路由插件，它和 Vue.js是深度集成的，适用于构建SPA单页面应用。Vue的单页面应用是基于路由和组件的，相对于传统页面基于 a 链接和页面，路由用于设定访问路径，并将路径和组建映射起来，这样就可以实现通过路由router来切换组建（视图）。

vue-router 提供了两个新组件：<router-link> 和 <router-view>

<router-link> 组件用于帮助用户进行视图导航，默认会被渲染成一个 <a></a>标签，a 标签用 href 属性来制定导航的目标地址，而 router-link 组件则用 to 属性来指定目标地址

<router-view> 组件负责渲染匹配到的视图组建，也就是 <router-link>指向的目标地址

先回顾 传统 a 标签实现页面跳转的写法：

<div class="router-demo">
    <div class="navbar">
        <a href="https://www.baidu.com/">百度</a>
        <a href="http://www.163.com/">网易</a>
        <a href="http://www.sina.com/">新浪</a>
    </div>
</div>

根据前面的介绍，我们尝试用 vue-router 来实现页面跳转，代码稍作修改

<div id="app">
    <div class="navbar">
        <!-- 使用 router-link 组件来导航. -->
        <!-- 通过传入 `to` 属性指定链接. -->
        <!-- <router-link> 默认会被渲染成一个 `<a>` 标签 -->
        <router-link to="/baidu">百度</router-link>
        <router-link to="/wangyi">网易</router-link>
        <router-link to="/xinlang">新浪</router-link>
    </div>
    <div class="content">
        <!-- 路由出口 -->
        <!-- 路由匹配到的组件将渲染在这里 -->
        <router-view></router-view>
    </div>
</div>

接下来编写js部分

1、定义组件

在 components 目录下分别新建三个组件

2、定义路由

运行 npm run dev 查看页面效果

三个 <router-link> 组件被渲染成了 <a> 标签，而 to 属性也变成了<a> 标签的 href 属性，再看看 <router-view> 也被渲染成对应的视图组件

https://router.vuejs.org/zh-cn/

根据官网的讲解，可以一步一步的实现上面这个简单的小demo，接下来，继续学习

router.js 的配置

mode：

默认为 hash，使用 hash 模式时，页面的路由地址会加一个 #，如上例所示： http://localhost:8080/#/wangyi

可以采用 history 模式来取消这个 #

base：

应用的基路径，例如，如果整个单页应用服务在 /app/ 下，base 就应该设为 “/app/”，一般写成 __dirname，在webpack 中有配置

routes：

包含了所有的页面配置，其中：

path： 就是访问的页面路径

name： 必须唯一，给页面路径定义的名字，页面跳转时，也可以用名字来跳

component： 组件，通过 import 导入。还有另一种写法 ---> 懒加载

懒加载的方式不需要用 import 引入组件，好处是当你访问该页面时才加载相关资源，这样的话就能提高页面的访问速度

component: resolve => require([‘../components/Baidu.vue‘], resolve)

编程式导航

除了 <router-link> 创建 a 标签来定义导航链接，我们还可以借助 router 的实例方法，通过编写代码来实现

router.push( location )

想要导航到不同的 url，则使用 router.push 方法，这个方法会向 history 栈添加一个新的记录。所以，当用户点击浏览器回退按钮时，则回到之前的 url

声明式	编程式
<router-link :to="...">	router.push( ... )

该方法的参数可以是一个字符串路径，也可以是一个描述地址的对象，例如：

// 字符串
router.push (‘home‘)

// 对象
router.push ({path: ‘home‘})

// 命名的路由
router.push ({name: ‘user‘, params: { userId: 123 }})

// 带查询参数，变成 /regsiter ? plan = private
router.push ({path: ‘register‘, query: { plan: ‘private‘}})

router.replace ( location )

跟 router.push 很像，唯一不同的是，它不会像 history 添加新的记录，而是跟它的方法名一样  --- 替换掉当前的 history 记录

声明式	编程式
<router-link :to = " ... " replace>	router.replace ( ... )

router.go ( n )

这个方法的参数是一个整数，意思是在history 记录中向前或者后退多少步，类似 window.history.go( n )

// 在浏览器中前进一步，等同于 history.forward( )
router.go ( 1 )

// 后退一步记录，等同于 history.back( )
router.go ( -1 )

// 前进 3步记录
router.go ( 3 )

//

导航钩子

正如其名，vue-router 提供的导航钩子用来 拦截导航，让它完成跳转或取消。比如做登录的拦截，而钩子函数根据其生效的范围可以分为：全局钩子函数、路由独享钩子函数 和 组件内钩子函数

全局钩子函数

可以直接在路由配置文件 router.js 里编写代码逻辑，可以做一些全局性的路由拦截，例如：用 router.beforeEach 注册一个全局的 before 钩子：

router.beforeEach ( (to, from, next) => {
    //do something
    next()
})

router.afterEach ( (to, from, next) => {
    console.log( to.path )
})

当一个导航触发时，全局的 before 钩子按照创建顺序调用，钩子是异步解析执行，此时导航在所有钩子 resolve 之前一直处于 等待中

每个钩子方法接收 三个参数：

to: Route: 即将要进入的目标，路由对象

from: Route: 当前导航正要离开的路由

next: Function：一定要调用该方法来 resolve 这个钩子，执行结果依赖 next( ) 方法的调用参数

> next(): 进行管道中的下一个钩子。如果全部钩子执行完了，则导航的状态就是 confirmed （确认的）。

> next(false): 中断当前的导航。如果浏览器的 URL 改变了（可能是用户手动或者浏览器后退按钮），那么 URL 地址会重置到 from 路由对应的地址。

> next(‘/‘) 或者 next({ path: ‘/‘ }): 跳转到一个不同的地址。当前的导航被中断，然后进行一个新的导航。

确保要调用 next 方法，否则钩子就不会被 resolved。

同样可以注册一个全局的 after 钩子，不过它不像 before 钩子那样，after 钩子没有 next 方法，不能改变导航：

router.afterEach(
    route => {  // ...}
)

路由独享钩子函数

可以做一些单个路由的跳转拦截，在配置文件编写代码即可

const router = new Router({
    routes: [
        {
            path: ‘/foo‘,
            component: Foo,
            beforeEnter: (to, from, next) => {
                // ...
            }
        }
    ]
})

组件内钩子函数

更细粒度的路由拦截，只针对一个进入某一个组件的拦截，可以在路由组件内直接定义以下路由导航钩子

beforeRouteEnter

beforeRouteUpdate (2.2 新增)

beforeRouteLeave

const Foo = {
  template: `...`,
  beforeRouteEnter (to, from, next) {    // 在渲染该组件的对应路由被 confirm 前调用
    // 不！能！获取组件实例 `this`
    // 因为当钩子执行前，组件实例还没被创建
  },
  beforeRouteUpdate (to, from, next) {    // 在当前路由改变，但是该组件被复用时调用
    // 举例来说，对于一个带有动态参数的路径 /foo/:id，在 /foo/1 和 /foo/2 之间跳转的时候，
    // 由于会渲染同样的 Foo 组件，因此组件实例会被复用。而这个钩子就会在这个情况下被调用。
    // 可以访问组件实例 `this`
  },
  beforeRouteLeave (to, from, next) {    // 导航离开该组件的对应路由时调用
    // 可以访问组件实例 `this`
  }
}

beforeRouteEnter 钩子 不能 访问 this，因为钩子在导航确认前被调用,因此即将登场的新组件还没被创建。

不过，你可以通过传一个回调给 next来访问组件实例。在导航被确认的时候执行回调，并且把组件实例作为回调方法的参数。

beforeRouteEnter (to, from, next) {
  next(vm => {    // 通过 `vm` 访问组件实例
  })
}

你可以 在 beforeRouteLeave 中直接访问 this。这个 leave 钩子通常用来禁止用户在还未保存修改前突然离开。可以通过 next(false) 来取消导航。

钩子函数使用场景

其实路由钩子函数在项目开发中用的并不是非常多，一般用于登录态的校验，没有登录跳转到登录页；权限的校验等等。当然随着项目的开发进展，也会有更多的功能可能用钩子函数实现会更好，我们知道有钩子函数这个好东西就行了，下次遇到问题脑海就能浮现，这个功能用钩子实现会比较棒

滚动行为

在利用vue-router去做跳转的时候，到了新页面如果对页面的滚动条位置有要求的话，可以利用下面这个方法

const router = new VueRouter({  routes: [...],
  scrollBehavior (to, from, savedPosition) {    
    // return 期望滚动到哪个的位置
  }
})

scrollBehavior 方法接收 to 和 from 路由对象。

第三个参数 savedPosition 当且仅当 popstate 导航 (mode为 history 通过浏览器的 前进/后退 按钮触发) 时才可用。

//所有路由新页面滚动到顶部：
scrollBehavior (to, from, savedPosition) {  
    return { x: 0, y: 0 }
}
//如果有锚点
scrollBehavior (to, from, savedPosition) {  
    if (to.hash) {    
        return {      
            selector: to.hash
        }
    }
}