首页 > 代码库 > vue-router 入门学习

vue-router 入门学习

对于单页面应用,尤其是移动端的网页应用,使用<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
        }
    }
}

























vue-router 入门学习