起步

注意

教程中的案例代码将使用 ES2015起步 - 图1 来编写。

同时，所有的例子都将使用完整版的 Vue 以解析模板。更多细节请移步这里起步 - 图2。

观看 Vue School 的关于 Vue Router 的免费视频课程 (英文)

用 Vue.js + Vue Router 创建单页应用，是非常简单的。使用 Vue.js ，我们已经可以通过组合组件来组成应用程序，当你要把 Vue Router 添加进来，我们需要做的是，将组件 (components) 映射到路由 (routes)，然后告诉 Vue Router 在哪里渲染它们。下面是个基本例子：

HTML

  1. <script src="https://unpkg.com/vue/dist/vue.js"></script>
  2. <script src="https://unpkg.com/vue-router/dist/vue-router.js"></script>
  4. <div id="app">
  5.   <h1>Hello App!</h1>
  6.   <p>
  7.     <!-- 使用 router-link 组件来导航. -->
  8.     <!-- 通过传入 `to` 属性指定链接. -->
  9.     <!-- <router-link> 默认会被渲染成一个 `<a>` 标签 -->
  10.     <router-link to="/foo">Go to Foo</router-link>
  11.     <router-link to="/bar">Go to Bar</router-link>
  12.   </p>
  13.   <!-- 路由出口 -->
  14.   <!-- 路由匹配到的组件将渲染在这里 -->
  15.   <router-view></router-view>
  16. </div>

JavaScript

  1. // 0. 如果使用模块化机制编程，导入Vue和VueRouter，要调用 Vue.use(VueRouter)
  3. // 1. 定义 (路由) 组件。
  4. // 可以从其他文件 import 进来
  5. const Foo = { template: '<div>foo</div>' }
  6. const Bar = { template: '<div>bar</div>' }
  8. // 2. 定义路由
  9. // 每个路由应该映射一个组件。 其中"component" 可以是
  10. // 通过 Vue.extend() 创建的组件构造器，
  11. // 或者，只是一个组件配置对象。
  12. // 我们晚点再讨论嵌套路由。
  13. const routes = [
  14.   { path: '/foo', component: Foo },
  15.   { path: '/bar', component: Bar }
  16. ]
  18. // 3. 创建 router 实例，然后传 `routes` 配置
  19. // 你还可以传别的配置参数, 不过先这么简单着吧。
  20. const router = new VueRouter({
  21.   routes // (缩写) 相当于 routes: routes
  22. })
  24. // 4. 创建和挂载根实例。
  25. // 记得要通过 router 配置参数注入路由，
  26. // 从而让整个应用都有路由功能
  27. const app = new Vue({
  28.   router
  29. }).$mount('#app')
  31. // 现在，应用已经启动了！

通过注入路由器，我们可以在任何组件内通过 this.$router 访问路由器，也可以通过 this.$route 访问当前路由：

  1. // Home.vue
  2. export default {
  3.   computed: {
  4.     username() {
  5.       // 我们很快就会看到 `params` 是什么
  6.       return this.$route.params.username
  7.     }
  8.   },
  9.   methods: {
  10.     goBack() {
  11.       window.history.length > 1 ? this.$router.go(-1) : this.$router.push('/')
  12.     }
  13.   }
  14. }

该文档通篇都常使用 router 实例。留意一下 this.$router 和 router 使用起来完全一样。我们使用 this.$router 的原因是我们并不想在每个独立需要封装路由的组件中都导入路由。

你可以看看这个在线的起步 - 图3例子。

要注意，当 <router-link> 对应的路由匹配成功，将自动设置 class 属性值 .router-link-active。查看 API 文档 学习更多相关内容。