共计 7517 个字符，预计需要花费 19 分钟才能阅读完成。
一、前言
要学习 vue-router 就要先知道这里的路由是什么？为什么我们不能像原来一样直接用标签编写链接哪？vue-router 如何使用？常见路由操作有哪些？等等这些问题，就是本篇要探讨的主要问题。
二、vue-router 是什么
这里的路由并不是指我们平时所说的硬件路由器，这里的路由就是 SPA（单页应用）的路径管理器。再通俗的说，vue-router 就是 WebApp 的链接路径管理系统。vue-router 是 Vue.js 官方的路由插件，它和 vue.js 是深度集成的，适合用于构建单页面应用。vue 的单页面应用是基于路由和组件的，路由用于设定访问路径，并将路径和组件映射起来。传统的页面应用，是用一些超链接来实现页面切换和跳转的。在 vue-router 单页面应用中，则是路径之间的切换，也就是组件的切换。路由模块的本质 就是建立起 url 和页面之间的映射关系。
至于我们为啥不能用 a 标签，这是因为用 Vue 做的都是单页应用（当你的项目准备打包时，运行 npm run build 时，就会生成 dist 文件夹，这里面只有静态资源和一个 index.html 页面），所以你写的标签是不起作用的，你必须使用 vue-router 来进行管理。
三、vue-router 实现原理
SPA(single page application): 单一页面应用程序，只有一个完整的页面；它在加载页面时，不会加载整个页面，而是只更新某个指定的容器中内容。单页面应用 (SPA) 的核心之一是: 更新视图而不重新请求页面;vue-router 在实现单页面前端路由时，提供了两种方式：Hash 模式和 History 模式；根据 mode 参数来决定采用哪一种方式。
1、Hash 模式：
vue-router 默认 hash 模式 —— 使用 URL 的 hash 来模拟一个完整的 URL，于是当 URL 改变时，页面不会重新加载。hash（#）是 URL 的锚点，代表的是网页中的一个位置，单单改变 #后的部分，浏览器只会滚动到相应位置，不会重新加载网页，也就是说 hash 出现在 URL 中，但不会被包含在 http 请求中，对后端完全没有影响，因此改变 hash 不会重新加载页面；同时每一次改变 #后的部分，都会在浏览器的访问历史中增加一个记录，使用”后退”按钮，就可以回到上一个位置；所以说 Hash 模式通过锚点值的改变，根据不同的值，渲染指定 DOM 位置的不同数据。hash 模式的原理是 onhashchange 事件(监测 hash 值变化)，可以在 window 对象上监听这个事件。
2、History 模式：
由于 hash 模式会在 url 中自带 #，如果不想要很丑的 hash，我们可以用路由的 history 模式，只需要在配置路由规则时，加入 ”mode: ‘history'”, 这种模式充分利用了 html5 history interface 中新增的 pushState() 和 replaceState() 方法。这两个方法应用于浏览器记录栈，在当前已有的 back、forward、go 基础之上，它们提供了对历史记录修改的功能。只是当它们执行修改时，虽然改变了当前的 URL，但浏览器不会立即向后端发送请求。
//main.js 文件中
const router = new VueRouter({
mode: ‘history’,
routes: […]
})
当你使用 history 模式时，URL 就像正常的 url，例如 http://yoursite.com/user/id，比较好看！不过这种模式要玩好，还需要后台配置支持。因为我们的应用是个单页客户端应用，如果后台没有正确的配置，当用户在浏览器直接访问 http://oursite.com/user/id 就会返回 404，这就不好看了。所以呢，你要在服务端增加一个覆盖所有情况的候选资源：如果 URL 匹配不到任何静态资源，则应该返回同一个 index.html 页面，这个页面就是你 app 依赖的页面。
export const routes = [
{path: “/”, name: “homeLink”, component:Home}
{path: “/register”, name: “registerLink”, component: Register},
{path: “/login”, name: “loginLink”, component: Login},
{path: “*”, redirect: “/”}]
此处就设置如果 URL 输入错误或者是 URL 匹配不到任何静态资源，就自动跳到到 Home 页面
3、使用路由模块来实现页面跳转的方式
方式 1：直接修改地址栏
方式 2：this.$router.push(‘路由地址’)
方式 3：<router-link to=” 路由地址 ”></router-link>
四、vue-router 使用方式
1: 下载 npm i vue-router -S
2: 在 main.js 中引入 import VueRouter from ‘vue-router’;
3: 安装插件 Vue.use(VueRouter);
4: 创建路由对象并配置路由规则 let router = new VueRouter({routes:[{path:’/home’,component:Home}]});
5: 将其路由对象传递给 Vue 的实例，options 中加入 router:router
6: 在 app.vue 中留坑 <router-view></router-view>
具体实现请看如下代码：
//main.js 文件中引入
import Vue from ‘vue’;
import VueRouter from ‘vue-router’;
// 主体
import App from ‘./components/app.vue’;
import Home from ‘./components/home.vue’
// 安装插件
Vue.use(VueRouter); // 挂载属性
// 创建路由对象并配置路由规则
let router = new VueRouter({
routes: [
// 一个个对象
{path: ‘/home’, component: Home}
]
});
//new Vue 启动
new Vue({
el: ‘#app’,
// 让 vue 知道我们的路由规则
router: router, // 可以简写 router
render: c => c(App),
})
最后记得在在 app.vue 中“留坑”
//app.vue 中
<template>
<div>
<!– 留坑，非常重要 –>
<router-view></router-view>
</div>
</template>
<script>
export default {
data(){
return {}
}
}
</script>
五、vue-router 核心要点
1.vue-router 参数传递
声明式的导航 <router-link :to=”…”> 和编程式的导航 router.push(…)都可以传参，本文主要介绍前者的传参方法，同样的规则也适用于编程式的导航。
①用 name 传递参数
在路由文件 src/router/index.js 里配置 name 属性
routes: [
{
path: ‘/’,
name: ‘Hello’,
component: Hello
}
]
模板里 (src/App.vue) 用 $route.name 来接收比如：<p>{{$route.name}}</p>
②通过 <router-link> 标签中的 to 传参
这种传参方法的基本语法：
<router-link :to=”{name:xxx,params:{key:value}}”>valueString</router-link>
比如先在 src/App.vue 文件中
<router-link :to=”{name:’hi1′,params:{username:’jspang’,id:’555′}}”>Hi 页面 1 </router-link>
然后把 src/router/index.js 文件里给 hi1 配置的路由起个 name, 就叫 hi1.
{path:’/hi1′,name:’hi1′,component:Hi1}
最后在模板里 (src/components/Hi1.vue) 用 $route.params.username 进行接收.
{{$route.params.username}}-{{$route.params.id}}
③vue-router 利用 url 传递参数 —- 在配置文件里以冒号的形式设置参数。
我们在 /src/router/index.js 文件里配置路由
{
path:’/params/:newsId/:newsTitle’,
component:Params
}
我们需要传递参数是新闻 ID（newsId）和新闻标题（newsTitle）. 所以我们在路由配置文件里制定了这两个值。在 src/components 目录下建立我们 params.vue 组件，也可以说是页面。我们在页面里输出了 url 传递的的新闻 ID 和新闻标题。
<template>
<div>
<h2>{{msg}}</h2>
<p> 新闻 ID：{{$route.params.newsId}}</p>
<p> 新闻标题：{{$route.params.newsTitle}}</p>
</div>
</template>
<script>
export default {
name: ‘params’,
data () {
return {
msg: ‘params page’
}
}
}
</script>
在 App.vue 文件里加入我们的 <router-view> 标签。这时候我们可以直接利用 url 传值了
<router-link to=”/params/198/jspang website is very good”>params</router-link>
④使用 path 来匹配路由，然后通过 query 来传递参数
<router-link :to=”{name:’Query’,query: { queryId: status}}” >
router-link 跳转 Query
</router-link>
对应路由配置：
{
path: ‘/query’,
name: ‘Query’,
component: Query
}
于是我们可以获取参数：
this.$route.query.queryId
2. 单页面多路由区域操作
在一个页面里我们有 2 个以上 <router-view> 区域，我们通过配置路由的 js 文件，来操作这些区域的内容
①App.vue 文件，在 <router-view> 下面新写了两行 <router-view> 标签, 并加入了些 CSS 样式
<template>
<div id=”app”>
<img src=”./assets/logo.png”>
<router-link :to=”{name:’HelloWorld’}”><h1>H1</h1></router-link>
<router-link :to=”{name:’H1′}”><h1>H2</h1></router-link>
<router-view></router-view>
<router-view name=”left” style=”float:left;width:50%;background-color:#ccc;height:300px;”/>
<router-view name=”right” style=”float:right;width:50%;background-color:yellowgreen;height:300px;”/>
</div>
</template>
②需要在路由里配置这三个区域，配置主要是在 components 字段里进行
export default new Router({
routes: [
{
path: ‘/’,
name: ‘HelloWorld’,
components: {default: HelloWorld,
left:H1,// 显示 H1 组件内容 ’I am H1 page,Welcome to H1′
right:H2// 显示 H2 组件内容 ’I am H2 page,Welcome to H2′
}
},
{
path: ‘/h1’,
name: ‘H1′,
components: {default: HelloWorld,
left:H2,// 显示 H2 组件内容
right:H1// 显示 H1 组件内容
}
}
]
})
上边的代码我们编写了两个路径，一个是默认的‘/’，另一个是‘/Hi’. 在两个路径下的 components 里面，我们对三个区域都定义了显示内容。最后页面展示如下图：
3.vue-router 配置子路由(二级路由)
实际生活中的应用界面，通常由多层嵌套的组件组合而成。同样地，URL 中各段动态路径也按某种结构对应嵌套的各层组件，例如：
如何实现下图效果(H1 页面和 H2 页面嵌套在主页中)？
①首先用 <router-link> 标签增加了两个新的导航链接
<router-link :to=”{name:’HelloWorld’}”> 主页 </router-link>
<router-link :to=”{name:’H1′}”>H1 页面 </router-link>
<router-link :to=”{name:’H2′}”>H2 页面 </router-link>
②在 HelloWorld.vue 加入 <router-view> 标签，给子模板提供插入位置
<template>
<div class=”hello”>
<h1>{{msg}}</h1>
<router-view></router-view>
</div>
</template>
③在 components 目录下新建两个组件模板 H1.vue 和 H2.vue 两者内容类似，以下是 H1.vue 页面内容：
<template>
<div class=”hello”>
<h1>{{msg}}</h1>
</div>
</template>
<script>
export default {
data() {
return {
msg: ‘I am H1 page,Welcome to H1’
}
}
}
</script>
④修改 router/index.js 代码，子路由的写法是在原有的路由配置下加入 children 字段。
routes: [
{
path: ‘/’,
name: ‘HelloWorld’,
component: HelloWorld,
children: [{path: ‘/h1’, name: ‘H1’, component: H1},// 子路由的 <router-view> 必须在 HelloWorld.vue 中出现
{path: ‘/h2’, name: ‘H2’, component: H2}
]
}
]
4.$route 和 $router 的区别
我们先将这两者 console.log 打印出来：
$route 是“路由信息对象”，包括 path，params，hash，query，fullPath，matched，name 等路由信息参数。
① $route.path 字符串，对应当前路由的路径，总是解析为绝对路径，如 “/order”。
② $route.params 一个 key/value 对象，包含了 动态片段 和 全匹配片段，如果没有路由参数，就是一个空对象。
③ $route.query 一个 key/value 对象，表示 URL 查询参数。例如，对于路径 /foo?user=1，则有 $route.query.user 为 1，如果没有查询参数，则是个空对象。
④ $route.hash 当前路由的 hash 值 (不带 #)，如果没有 hash 值，则为空字符串。
⑤ $route.fullPath 完成解析后的 URL，包含查询参数和 hash 的完整路径。
⑥ $route.matched 数组，包含当前匹配的路径中所包含的所有片段所对应的配置参数对象。
⑦ $route.name 当前路径名字
$router 是“路由实例”对象，即使用 new VueRouter 创建的实例，包括了路由的跳转方法，钩子函数等。
$router 常见跳转方法
<button @click=”goToMenu” class=”btn btn-success”>Let’s order！</button>
…..
<script>
export default{
methods:{
goToMenu(){
this.$router.go(-1)// 跳转到上一次浏览的页面
this.$router.replace(‘/menu’)// 指定跳转的地址
this.$router.replace({name:’menuLink’})// 指定跳转路由的名字下
this.$router.push(‘/menu’)// 通过 push 进行跳转
this.$router.push({name:’menuLink’})// 通过 push 进行跳转路由的名字下
}
}
}
</script>
$router.push 和 $router.replace 的区别：
使用 push 方法的跳转会向 history 栈添加一个新的记录，当我们点击浏览器的返回按钮时可以看到之前的页面。
使用 replace 方法不会向 history 添加新记录，而是替换掉当前的 history 记录，即当 replace 跳转到的网页后，‘后退’按钮不能查看之前的页面。
5.404 页面的设置
用户会经常输错页面，当用户输错页面时，我们希望给他一个友好的提示页面，这个页面就是我们常说的 404 页面。vue-router 也为我们提供了这样的机制。①设置我们的路由配置文件（/src/router/index.js）
{
path:’*’,
component:Error
}
这里的 path:’*’ 就是输入地址不匹配时，自动显示出 Error.vue 的文件内容
②在 /src/components/ 文件夹下新建一个 Error.vue 的文件。简单输入一些有关错误页面的内容。
<template>
<div>
<h2>{{msg}}</h2>
</div>
</template>
<script>
export default {
data () {
return {
msg: ‘Error:404’
}
}
}
</script>
此时我们随意输入一个错误的地址时，便会自动跳转到 404 页面
如果觉得文章对你有些许帮助，欢迎在我的 GitHub 博客点赞和关注，感激不尽！
六、参考文章
vue-router 实现单页面路由原理
Vue.js——vue-router 60 分钟快速入门
技术胖的 Vue-router 视频教程
vue 中 $router 以及 $route 的使用
Vue2.0 探索之路——vue-router 入门教程和总结
vue-router 2.0 一些区别
