从 Vue Router 0.7.x 迁移

只有 Vue Router 2 是与 Vue 2 相互兼容的，所以如果你更新了 Vue ，你也需要更新 Vue Router 。这也是我们在主文档中将迁移路径的详情添加进来的原因。
有关使用 Vue Router 2 的完整教程，请参阅 Vue Router 文档。

Router 初始化

router.start ^替换

不再会有一个特殊的 API 用来初始化包含 Vue Router 的 app ，这意味着不再是：

router.start({
  template: '<router-view></router-view>'
}, '#app')

你只需要传一个路由属性给 Vue 实例：

new Vue({
  el: '#app',
  router: router,
  template: '<router-view></router-view>'
})

或者，如果你使用的是运行时构建 (runtime-only) 方式：

new Vue({
  el: '#app',
  router: router,
  render: h => h('router-view')
})

Route 定义

router.map ^替换

路由现在被定义为一个在 router 实例里的一个routes 选项数组。所以这些路由：

router.map({
  '/foo': {
    component: Foo
  },
  '/bar': {
    component: Bar
  }
})

会以这种方式定义：

var router = new VueRouter({
  routes: [
    { path: '/foo', component: Foo },
    { path: '/bar', component: Bar }
  ]
})

考虑到不同浏览器中遍历对象不能保证会使用相同的键值，这种数组的语法可以保证更多可预测的路由匹配。

router.on ^移除

如果你需要在启动的 app 时通过代码生成路由，你可以动态地向路由数组推送定义来完成这个操作。举个例子：

// 普通的路由
var routes = [
  // ...
]
// 动态生成的路由
marketingPages.forEach(function (page) {
  routes.push({
    path: '/marketing/' + page.slug
    component: {
      extends: MarketingComponent
      data: function () {
        return { page: page }
      }
    }
  })
})
var router = new Router({
  routes: routes
})

如果你需要在 router 被实例化后增加新的路由，你可以把 router 原来的匹配方式换成一个包括你新添的加路由的匹配方式：

router.match = createMatcher(
  [{
    path: '/my/new/path',
    component: MyComponent
  }].concat(router.options.routes)
)

subRoutes ^换名

出于 Vue Router 和其他路由库一致性的考虑，重命名为children

router.redirect ^替换

现在用一个路由定义的选项作为代替。 举个例子，你将会更新：

router.redirect({
  '/tos': '/terms-of-service'
})

成像下面的routes配置里定义的样子：

{
  path: '/tos',
  redirect: '/terms-of-service'
}

router.alias ^替换

现在是你进行 alias 操作的路由定义里的一个选项。举个例子，你需要在你的routes定义里将：

router.alias({
  '/manage': '/admin'
})

配置这个样子：

{
  path: '/admin',
  component: AdminPanel,
  alias: '/manage'
}

如果你需要进行多次 alias 操作，你也可以使用一个数组语法去实现：

alias: ['/manage', '/administer', '/administrate']

任意的 Route 属性 ^替换

现在任意的 route 属性必须在新 meta 属性的作用域内，以避免和以后的新特性发生冲突。举个例子，如果你以前这样定义：

'/admin': {
  component: AdminPanel,
  requiresAuth: true
}

你现在需要把它更新成：

{
  path: '/admin',
  component: AdminPanel,
  meta: {
    requiresAuth: true
  }
}

如果在一个路由上访问一个属性，你仍然会通过 meta 。举个例子：

if (route.meta.requiresAuth) {
  // ...
}

Route 匹配

路由匹配现在使用 path-to-regexp 这个包，这将会使得工作与之前相比更加灵活。

一个或者更多的命名参数 ^改变

语法稍微有些许改变，所以以/category/*tags为例，应该被更新为/category/:tags+。

链接

v-link ^替换

v-link指令已经被一个新的<router-link> 组件指令替代，这一部分的工作已经被 Vue 2 中的组件完成。这将意味着在任何情况下，如果你拥有这样一个链接：

<a v-link="'/about'">About</a>

你需要把它更新成：

<router-link to="/about">About</router-link>

Note that target="_blank" is not supported on <router-link>, so if you need to open a link in a new tab, you have to use <a> instead.

v-link-active ^替换

The v-link-active directive has also been replaced by the tag attribute on the <router-link> component. So for example, you’ll update this:

v-link-active也因为指定了一个在 <router-link> 组件上的 tag 属性而被弃用了。举个例子，你需要更新：

<li v-link-active>
  <a v-link="'/about'">About</a>
</li>

成这个写法:

<router-link tag="li" to="/about">
  <a>About</a>
</router-link>

<a>标签将会成为真实的链接（并且可以获取到正确的跳转），但是激活的类将会被应用在外部的<li>标签上。

编程导航

router.go ^改变

为了与 HTML5 History API 保持一致性，router.go 已经被用来作为 后退/前进导航，router.push 用来导向特殊页面。

路由选择：Modes

hashbang: false ^移除

Hashbangs 将不再为谷歌需要去爬去一个网址，所以他们将不再成为哈希策略的默认选项。

history: true ^替换

所有路由模型选项将被简化成一个单个的mode 选项。 你需要更新：

var router = new VueRouter({
  history: 'true'
})

成这个写法：

var router = new VueRouter({
  mode: 'history'
})

abstract: true ^替换

所有路由模型选项将被简化成一个单个的mode 选项。 你需要更新：

var router = new VueRouter({
  abstract: 'true'
})

成这个写法：

var router = new VueRouter({
  mode: 'abstract'
})

路由选项：Misc

saveScrollPosition ^替换

它已经被替换为可以接受一个函数的scrollBehavior 选项，所以滑动行为可以完全的被定制化处理 - 甚至为每次路由进行定制也可以满足。这将会开启很多新的可能，但是简单的复制旧的行为:

saveScrollPosition: true

你可以替换为:

scrollBehavior: function (to, from, savedPosition) {
  return savedPosition || { x: 0, y: 0 }
}

root ^换名

为了与HTML 的<base>标签保持一致性，重命名为base。

transitionOnLoad ^移除

由于 Vue 的过渡系统appear transition control的存在，这个选项将不再需要。

suppressTransitionError ^移除

出于简化钩子的考虑被移除。如果你真的需要抑制过渡错误，你可以使用 try…catch作为替代。

路由挂钩

activate ^替换

使用beforeRouteEnter这一组件进行替代。

canActivate ^替换

使用beforeEnter 在路由中作为替代。

deactivate ^移除

使用beforeDestroy 或者 destroyed 钩子作为替代。

canDeactivate ^替换

在组件中使用beforeRouteLeave 作为替代。

canReuse: false ^移除

在新的 Vue 路由中将不再被使用。

data ^替换

$route属性是响应式的，所有你可以就使用一个 watcher 去响应路由的改变，就像这样：

watch: {
  '$route': 'fetchData'
},
methods: {
  fetchData: function () {
    // ...
  }
}

$loadingRouteData ^移除

定义你自己的属性（例如：isLoading），然后在路由上的 watcher 中更新加载状态。举个例子，如果使用axios获取数据：

data: function () {
  return {
    posts: [],
    isLoading: false,
    fetchError: null
  }
},
watch: {
  '$route': function () {
    var self = this
    self.isLoading = true
    self.fetchData().then(function () {
      self.isLoading = false
    })
  }
},
methods: {
  fetchData: function () {
    var self = this
    return axios.get('/api/posts')
      .then(function (response) {
        self.posts = response.data.posts
      })
      .catch(function (error) {
        self.fetchError = error
      })
  }
}