使用 Vue.js 时,我们就已经把组件组合成一个应用了,当我们要把 vue-router 加进来,只需要配置组件和路由映射,然后告诉 vue-router 在哪里渲染它们。
先来看一下官方提供的最简单的例子:
HTML
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<script src="https://unpkg.com/vue-router/dist/vue-router.js"></script>
<div id="app">
<h1>Hello App!</h1>
<p>
<!-- 使用 router-link 组件来导航. -->
<!-- 通过传入 `to` 属性指定链接. -->
<!-- <router-link> 默认会被渲染成一个 `<a>` 标签 -->
<router-link to="/foo">Go to Foo</router-link>
<router-link to="/bar">Go to Bar</router-link>
</p>
<!-- 路由出口 -->
<!-- 路由匹配到的组件将渲染在这里 -->
<router-view></router-view>
</div>
从HTML文件里面我们需要学会的是:
- <router-link>标签是我们要跳转的链接,to=""是必须的属性,双引号中的内容是我们接下来在JS文件中定义的路由path。
- <router-view>标签是展示我们匹配到的组件的区域。
JavaScript
// 0. 如果使用模块化机制编程,导入Vue和VueRouter,要调用 Vue.use(VueRouter)
// 1. 定义(路由)组件。
// 也可以从其他文件 import 进来
const Foo = { template: '<div>foo</div>' }
const Bar = { template: '<div>bar</div>' }
// 2. 定义路由
// 每个路由应该映射一个组件。 其中"component" 可以是
// 通过 Vue.extend() 创建的组件构造器,
// 或者,只是一个组件配置对象。
const routes = [
{ path: '/foo', component: Foo },
{ path: '/bar', component: Bar }
]
// 3. 创建 router 实例,然后传 `routes` 配置
// 你还可以传别的配置参数, 不过先这么简单着吧。
const router = new VueRouter({
routes // (缩写)相当于 routes: routes
})
// 4. 创建和挂载根实例。
// 记得要通过 router 配置参数注入路由,
// 从而让整个应用都有路由功能
const app = new Vue({
router
}).$mount('#app')
// 现在,应用已经启动了!
JavaScript文件主要做的事情是:
- 定义路由列表,即routes。
- 创建router实例及router配置,即router。
- 创建和挂载根实例。
以上只是教我们用最简单的方法使用vue-router。但实际开发过程中,首先我们的vue组件显然不会只有一个template模板这么简单,会用到vue的单文件组件;其次我们通常会希望<router-view>的范围是整个页面,而不是像现在这样一直有几个碍眼的导航存在于页面上,这就需要先定义好默认状态下<router-view>显示的内容。
既然是单页应用(SPA),那么整个项目有以下三个文件是必要的:
- 一个html文件:index.html
- 一个webpack打包时的入口js文件:main.js
- 一个根vue组件,作为其他组件的挂载点:app.vue
另外还有两个自定义组件:homepage.vue和chat.vue。我们希望的结果是他们之间互相跳转。
下面看下这几个文件的具体内容:
index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>Vue.js v2</title>
</head>
<body>
<!--因为我们用App.vue作为根组件,这里只需要写一个渲染用的挂载元素#application即可-->
<div id="application"></div>
<!--这里的dist目录是webpack打包后的js文件的路径-->
<script src="dist/main.js"></script>
</body>
</html>
main.js
这里我们选择把路由配置也写到main.js中,你也可以写到一个单独的router.js中再引入到main.js中。
//引入vue、vue-router和根组件app.vue
import Vue from 'vue'
import VueRouter from 'vue-router'
import App from './components/app.vue'
Vue.use(VueRouter)
// 引入自定义组件
import HomePage from './components/homepage.vue'
import Chat from './components/chat/chat.vue'
//定义路由
const routes = [
//这里 path: '/' 代表应用首页显示的内容
{ path: '/', component: HomePage },
{ path: '/chat', component: Chat }
];
//创建router实例
const router = new VueRouter({
//mode指定路由模式,默认'hash',另一种可选的模式是'history'
mode: 'hash',
routes,
});
new Vue({
el: '#application',
router,
render: h => h(App) //用render函数渲染引入的组件App.vue到index.html中的#application元素中
})
app.vue
<template lang="html">
<div id="app">
<!--这里是组件的渲染区域-->
<router-view></router-view>
</div>
</template>
<script>
export default {
data () {
return {
}
},
}
</script>
自定义组件 homepage.vue
这个组件的内容也是进入应用默认展示的页面内容。
<template>
<div>
<h1>homepage</h1>
<router-link to="/chat">Go to chat</router-link>
</div>
</template>
自定义组件 chat.vue
<template>
<div>
<h1>Chat</h1>
<router-link to="/">Go to homepage</router-link>
</div>
</template>
写完后你会发现这两个页面是互相跳转的,没错,就是这样。
一般我们会把路由信息routes提取到一个单独的文件中,像这样:
路由信息提取到单独文件中 route-config.js:
import HomePage from './components/homepage.vue'
import Chat from './components/chat/chat.vue'
export default [
{
path: '/',
component: HomePage
},
{
path: '/chat',
component: Chat
}
];
然后在main.js
中引入: import routes from './route-config.js'
就可以了。
参考文献:
- vue-router 2官方文档: http://router.vuejs.org/zh-cn/
- Vue-router2.0学习笔记: https://segmentfault.com/a/11...
- vue2.0构建单页应用最佳实战: https://segmentfault.com/a/11...
- 一个完整的vue应用 ( vuex+vue-router ) 起手: https://segmentfault.com/a/11...
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。