首页 前端知识 【Vue实战教程】之 Vue Router 路由详解

【Vue实战教程】之 Vue Router 路由详解

2024-09-28 23:09:22 前端知识 前端哥 667 435 我要收藏

Vue Router路由

1 路由基础

1.1 什么是路由

用Vue.js创建的项目是单页面应用,如果想要在项目中模拟出来类似于页面跳转的效果,就要使用路由。其实,我们不能只从字面的意思来理解路由,从字面上来看,很容易把路由联想成“路由器”。路由器的功能用一句话来概括,就是连接两个或多个网络的硬件设备。我们所说的路由,是指在一个应用程序中链接多个页面(组件)的一种配置,在一个全栈项目中,路由分为前端路由和后端路由。

后端路由

先来看一下后端路由,例如项目的服务器地址是 http://192.168.1.10:8080 ,在这个站点中提供了3个界面,分别是:

页面1,地址 http://192.168.1.10:8080/index.html
页面2,地址 http://192.168.1.10:8080/about.html
页面3,地址 http://192.168.1.10:8080/news.html

当我们在浏览器中输入 http://192.168.1.10:8080/index.html 时,web服务器接收到这个请求,然后把 “/index.html” 解析出来,再找到 index.html 文件并响应给浏览器,这就是服务器端的路由分发。

前端路由

虽然前端路由和后端路由在实现技术上有些差别,但是实现的原理都是一样的。在HTML5的 history API 发布之前,前端路由功能都是通过 hash散列计算的,因为 hash 算法可以兼容低版本的浏览器,例如:

http://192.168.1.10:8080/#/index.html
http://192.168.1.10:8080/#/about.html
http://192.168.1.10:8080/#/news.html

由于web服务不会解析#后面的内容,而JavaScript是可以拿到#后面的内容的,那么就可以使用 window.location.hash 来读取,通过这个方法来匹配到不同的功能上。使用hash的方式还有一个很大的优点,当hash的值改变后,不会导致浏览器的刷新。

1.2 在Vue中使用路由

用 Vue.js + Vue Router 创建单页应用,是非常简单的。要在Vue.js应用程序中使用路由,需要先安装 vue-router ,在当前项目下启动命令行工具,命令如下:

npm install vue-router

如果在一个模块化工程中使用它,必须要通过 Vue.use() 明确地安装路由功能:

import Vue from 'vue'
import VueRouter from 'vue-router'

Vue.use(VueRouter)

如果是使用脚手架工具创建的项目,路由的配置在 /src/router/index.js 文件中。

注意 如果使用全局的 script 标签,就无需上面的操作了。

在脚手架工具创建的项目中使用路由,需要在 /src/router/index.js 路由配置文件创建路由对象,然后将路由配置文件引入到 main.js 入口文件并注册到Vue实例上。上面的流程操作完成后,就可以在页面组件中使用路由的内置组件 router-link 和 router-view 进行页面跳转了。
/router/index.js 文件代码如下:

import Vue from 'vue'
import VueRouter from 'vue-router'

Vue.use(VueRouter)

const routes = [
  {
    path: '/home',
    name: 'Home',
    component: ()=> import('@/views/Home.vue')
  }
]

const router = new VueRouter({
  mode: 'history',
  base: process.env.BASE_URL,
  routes
})

export default router

/main.js 文件代码如下:

import Vue from 'vue'
import App from './App.vue'
import router from './router'

new Vue({
  router,
  render: h => h(App)
}).$mount('#app')

/App.vue 文件代码如下:

<template>
  <div>
    <div>
	<!-- 用于跳转路由的链接,to属性为跳转地址 -->
      <router-link to="/home">Home页面</router-link>
    </div>
	
<!-- 路由匹配的组件会渲染到router-view -->
    <router-view/>
  </div>
</template>

/views/Home.vue 文件代码如下:

<template>
  <div>
    这是Home页面!
  </div>
</template>

在Google Chrome浏览器运行,打开项目根目录会显示 router-link 的超链接效果,如下图所示;
在这里插入图片描述

点击超链接后,跳转到 http://localhost:8080/home 路由下并渲染 Home.vue 视图,效果如下图所示。
在这里插入图片描述

1.3 动态路由

在很多时候,我们需要从一个页面跳转到另一个页面,并且携带参数,这种应用场景下就可以使用动态路由。动态路由可以将某种模式匹配到所有路由,全部映射到同一个组件上。例如,我们需要访问一个商品页面的组件 goods.vue 文件,对于所有要访问这个页面组件的用户来说,都要使用这个组件进行视图渲染。那么就可以在 vue-router 的路由路径中使用“动态路径参数”来达到这个效果。
一个“路径参数”使用冒号 : 标记。当匹配到一个路由时,参数值会被设置到 this.$route.params,可以在每个组件内使用。
/router/index.js 文件代码如下:

import Vue from 'vue'
import VueRouter from 'vue-router'

Vue.use(VueRouter)

const routes = [
  {
    path: '/goods/:gid',
    name: 'Goods',
    component: ()=> import('@/views/Goods.vue')
  }
]

const router = new VueRouter({
  mode: 'history',
  base: process.env.BASE_URL,
  routes
})

export default router

/App.vue 文件代码如下:

<template>
  <div>
    <div>
	<!-- 用于跳转路由的链接,to属性为跳转地址 -->
      <router-link to="/goods/1001">查看商品</router-link>
    </div>
	
<!-- 路由匹配的组件会渲染到router-view -->
    <router-view/>
  </div>
</template>

/views/Goods.vue 文件代码如下:

<template>
<div>
商品详情页面
<p>
商品ID:{{$route.params.gid}}
</p>
	</div>
</template>

在Google Chrome浏览器中运行,项目根目录下会显示“查看商品”的超链接,效果如下图所示;
在这里插入图片描述

当点击超链接,页面跳转到 /goods 商品详情路由下,并渲染 Goods.vue 视图,在商品详情页面中会显示传递过来的商品id参数值,效果如下图所示。
在这里插入图片描述

可以在一个路由中设置多段“路径参数”,对应的值都会设置到 $route.params 中。参数设置参考如下表所示。
在这里插入图片描述

除了 $route.params 外,$route 对象还提供了其它有用的信息,例如,$route.query (在 URL中设置查询参数)、$route.hash 等等。

1.4 嵌套路由

在实际生活中的应用界面,通常由多层嵌套的组件组合而成,在配置路由的过程中,需要对URL进行分层管理,使每一个路由都能按照嵌套的顺序进行编写。我们还以商城类应用为例,在商品分类页面,点击某一个类别,要跳转到商品的列表页面,那么该商品列表页面的路由就由商品分类+商品列表组成。
/App.vue 文件代码如下:

<template>
  <div>
    <!-- 路由匹配的组件会渲染到router-view -->
    <router-view/>
  </div>
</template>

在上面代码中的 是最顶层的出口,渲染最高级路由匹配到的组件。同样地,一个被渲染组件同样可以包含自己的嵌套 。例如,在 Classify.vue 组件的模板添加一个 。
/views/Classify.vue 文件代码如下:

<template>
<div>
<div>
<router-link to="/classify/list/1">男装</router-link> &nbsp;&nbsp;
<router-link to="/classify/list/2">女装</router-link> &nbsp;&nbsp;
<router-link to="/classify/list/3">童装</router-link> 
</div>
		
<router-view></router-view>
</div>
</template>

/views/GoodsList.vue 文件代码如下:

<template>
<div>
商品列表页 -- 分类id:{{$route.params.tid}}
</div>
</template>

要在嵌套的出口中渲染组件,需要在 VueRouter 的参数中使用 children 配置。
/router/index.js 文件代码如下:

import Vue from 'vue'
import VueRouter from 'vue-router'

Vue.use(VueRouter)

const routes = [
  {
    path: '/classify',
    name: 'Classify',
    component: ()=> import('@/views/Classify.vue'),
	children: [
	  {
	        path: '/classify/list/:tid',
	        name: 'GoodsList',
	        component: ()=> import('@/views/GoodsList.vue')
	  }
	]
  }
]

const router = new VueRouter({
  mode: 'history',
  base: process.env.BASE_URL,
  routes
})

export default router

在Google Chrome浏览器中运行,访问 /classify 路由时打开商品分类页面,效果如下图所示;
在这里插入图片描述

当点击不同的商品类别时,跳转到 /classify/list/:tid 路由,渲染商品列表页面视图,并动态的获取当前商品列表的id,效果如下图所示。
在这里插入图片描述

1.5 编程式导航

除了使用 创建 a 标签来定义导航链接,我们还可以借助 router 的实例方法,通过编写代码来实现。

push函数

语法:

router.push(location, onComplete?, onAbort?)

想要导航到不同的 URL,则使用 router.push 方法。这个方法会向 history 栈添加一个新的记录,所以,当用户点击浏览器后退按钮时,则回到之前的 URL。在 Vue 实例内部,可以通过 $router 访问路由实例,具体操作为 this.$router.push
当你点击 <router-link> 时,这个方法会在内部调用,所以说,点击 <router-link :to="..."> 等同于调用 router.push(...)
声明式代码:

<router-link :to="...">

编程式代码:

router.push(...)

该方法的参数可以是一个字符串路径,或者一个描述地址的对象,代码如下:

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

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

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

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

如果提供了 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 属性。

replace函数

语法:

router.replace(location, onComplete?, onAbort?)

router.replacerouter.push 很像,唯一的不同就是,它不会向 history 添加新记录,而是跟它的方法名一样 ,替换掉当前的 history 记录。
声明式示例代码:

<router-link :to="..." replace>

编程式示例代码:

router.replace(...)

go函数

语法:

router.go(n)

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

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

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

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

// 如果 history 记录不够用,那就默默地失败呗
router.go(-100)
router.go(100)

2 路由的相关配置

2.1 命名路由

在开发过程中,使用路由跳转的过程中如果每次都用path会显得比较麻烦,如果能通过一个名称来标识一个路由,会显得更加方便。在vue-router中就有关于命名路由的配置项,创建Router实例的时候,在routes配置中可以给某个路由设置名称。代码如下:

const router = new VueRouter({
  routes: [
    {
      path: '/user/:userId',
      name: 'user',
      component: User
    }
  ]
})

要链接到一个命名路由,可以给 router-link 的 to 属性传一个对象,代码如下:

<router-link :to="{ 
name: 'user', 
params: { userId: 123 }
}">User</router-link>

这跟代码调用 router.push() 的效果是一样的。代码如下:

router.push({ name: 'user', params: { userId: 123 }})

上面这两种方式都会把路由导航到 /user/123 路径。

2.2 命名视图

有时候想同时 (同级) 展示多个视图,而不是嵌套展示,例如创建一个布局,有 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
      }
    }
  ]
})
2.3 重定向

在实际开发中,当对一个页面的功能操作完成后,需要自动完成跳转,或者是访问某个路由链接时,需要自动访问另外一个链接,这就要用到路由的重定向配置。重定向可以通过routes配置来完成,代码如下:

const router = new VueRouter({
  routes: [
    { path: '/a', redirect: '/b' }
  ]
})

重定向的目标也可以是一个命名的路由,代码如下:

const router = new VueRouter({
  routes: [
    { path: '/a', redirect: { name: 'foo' }}
  ]
})

还可以通过一个方法,动态返回重定向目标,代码如下:

const router = new VueRouter({
  routes: [
    { path: '/a', redirect: to => {
      // 方法接收 目标路由 作为参数
      // return 重定向的 字符串路径/路径对象
    }}
  ]
})

3 路由的模式

在讲解vue-router的路由模式之前,首先要先认识路由的组成,每个路由都是由多个URL组成,使用不同的URL可以相应的导航到不同的位置。对于服务器端访问来说,HTTP请求是无状态的,所以当请求服务器不同的地址来切换页面时,都会重新进行请求。而在使用vue-router在前端做页面切换时,并没有让浏览器刷新,这是因为借助了浏览器的History API来实现的,使得页面跳转而浏览器不做刷新操作,页面的状态就被维持在浏览器中了。
vue-router中默认是hash模式,URL地址的格式为 http://localhost:8080/#/ ,在URL中带有#号。可以在 router 实例中修改路由的模式,代码如下:

const router = new VueRouter({
  mode: 'history',
  base: process.env.BASE_URL,
  routes
})

当路由的模式设置为 history 模式后,URL地址中的#就会被去除了。

4 导航守卫

导航守卫又称为路由守卫,用来实时监控路由跳转的过程,在路由跳转的各个过程中执行相应的钩子函数,这就类似于Vue的生命周期钩子,在实际开发中经常被使用。例如,当用户点击一个页面时,如果当前用户为登录,就自动跳转到登录页面,如果是已经登录,就让用户正常进入。
导航守卫分为全局守卫、路由独享守卫和组件内守卫,这三种方式应用的场景不同,都有自己的钩子函数,具体内容如下。

4.1 全局守卫

全局守卫的钩子函数三个,分别是:

  • router.beforeEach(全局前置守卫)
  • router.beforeResolve(全局解析守卫)
  • router.afterEach(全局后置守卫)

router.beforeEach(全局前置守卫)

可以使用 router.beforeEach 注册一个全局前置守卫,代码如下:

const router = new VueRouter({ ... })

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

当一个导航触发时,全局前置守卫按照创建顺序调用。守卫是异步解析执行,此时导航在所有守卫 resolve 完之前一直处于 等待中。
每个守卫方法接收三个参数:

  • to:是一个Route对象,表示即将要进入的目标路由对象。
  • from:是一个Route对象,表示当前导航正要离开的路由。
  • next:是一个函数对象,必须要调用该方法来完成这个钩子,执行效果依赖 next 方法的调用参数。

router.beforeResolve(全局解析守卫)

和全局前置守卫类似,区别是在跳转被确认之前,同时在所有组件内守卫和异步路由组件都被解析之后,解析守卫才调用。

router.afterEach(全局后置钩子)

可以注册全局后置钩子,然而和守卫不同的是,这些钩子只接受to和from,不会接受 next 函数也不会改变导航本身。

4.2 路由独享守卫

独享守卫只有一种:beforeEnter。该守卫接收的参数与全局守卫是一样的,但是该守卫只在其他路由跳转至配置有beforeEnter路由表信息时才生效。
router配置文件配置如下:

const router = new VueRouter({
  routes: [
    {
      path: '/foo',
      component: Foo,
      beforeEnter: (to, from, next) => {
        // ...
      }
    }
  ]
})
4.3 组件内守卫

组件内守卫是在组件内部直接定义的,有以下三个钩子函数。

  • 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` 访问组件实例
  })
}

注意 beforeRouteEnter 是支持给 next 传递回调的唯一守卫。对于 beforeRouteUpdate 和
beforeRouteLeave 来说,this 已经可用了,所以不支持传递回调,因为没有必要了。

转载请注明出处或者链接地址:https://www.qianduange.cn//article/18668.html
标签
评论
发布的文章
大家推荐的文章
会员中心 联系我 留言建议 回顶部
复制成功!