Vue 从 Vue Router 0.7.x 迁移

优质

小牛编辑

133浏览

2023-12-01

只有 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')
})

升级路径

运行迁移助手找到 router.start 被调用的示例。

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.map 被调用的示例。

`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)
)

升级路径

运行迁移助手找到 router.on 被调用的示例。

`subRoutes` ^换名

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

升级路径

运行迁移助手找到 subRoutes 选项的示例。

`router.redirect` ^替换

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

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

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

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

升级路径

运行迁移助手找到 router.redirect 被调用的示例。

`router.alias` ^替换

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

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

配置这个样子：

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

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

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

升级路径

运行迁移助手找到 router.alias 被调用的示例。

任意的 Route 属性 ^替换

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

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

你现在需要把它更新成：

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

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

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

升级路径

运行迁移助手找到任意的路由不在 meta 作用域下的示例。

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 指令的示例。

`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>标签上。

升级路径

运行迁移助手找到 v-link-active 指令的示例

编程导航

`router.go` ^改变

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

升级路径

运行迁移助手，找到 router.go 和 router.push 指令被调用的示例。

路由选择：Modes

`hashbang: false` ^移除

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

升级路径

运行迁移助手找到 hashbang: false 选项的示。

`history: true` ^替换

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

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

成这个写法：

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

升级路径

运行迁移助手找到 history: true 选项的示。

`abstract: true` ^替换

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

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

成这个写法：

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

升级路径

运行迁移助手找到 abstract: true 选项的示例。

路由选项：Misc

`saveScrollPosition` ^替换

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

saveScrollPosition: true

你可以替换为:

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

升级路径

运行迁移路径找到 saveScrollPosition: true 选项的示例。

`root` ^换名

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

升级路径

运行迁移路径找到 root 选项的示例。

`transitionOnLoad` ^移除

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

升级路径

运行迁移路径找到 transitionOnLoad: true 选项的示例。

`suppressTransitionError` ^移除

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

升级路径

运行迁移指令找到 suppressTransitionError: true 选项的示例。

路由挂钩

`activate` ^替换

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

升级路径

运行迁移路径找到 beforeRouteEnter 钩子的示例。

`canActivate` ^替换

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

升级路径

运行迁移路径找到 canActivate 钩子的示例。

`deactivate` ^移除

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

升级路径

运行迁移路径找到 deactivate 钩子的示例。

`canDeactivate` ^替换

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

升级路径

运行迁移路径找到 canDeactivate 钩子的示例。

`canReuse: false` ^移除

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

升级路径

运行迁移助手找到 canReuse: false 选项的示例。

`data` ^替换

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

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

升级路径

运行迁移助手找到 data 钩子的示例。

`$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
      })
  }
}

原文： http://vuejs.org/guide/migration-vue-router.html

Vue 从 Vue Router 0.7.x 迁移

Router 初始化

router.start 替换

升级路径

Route 定义

router.map 替换

升级路径

router.on 移除

升级路径

subRoutes 换名

升级路径

router.redirect 替换

升级路径

router.alias 替换

升级路径

任意的 Route 属性 替换

升级路径

Route 匹配

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

升级路径

链接

v-link 替换

升级路径

v-link-active 替换

升级路径

编程导航

router.go 改变

升级路径

路由选择：Modes

hashbang: false 移除

升级路径

history: true 替换

升级路径

abstract: true 替换

升级路径

路由选项：Misc

saveScrollPosition 替换

升级路径

root 换名

升级路径

transitionOnLoad 移除

升级路径

suppressTransitionError 移除

升级路径

路由挂钩

activate 替换

升级路径

canActivate 替换

升级路径

deactivate 移除

升级路径

canDeactivate 替换

升级路径

canReuse: false 移除

升级路径

data 替换

升级路径

$loadingRouteData 移除

`router.start` ^替换

`router.map` ^替换

`router.on` ^移除

`subRoutes` ^换名

`router.redirect` ^替换

`router.alias` ^替换

任意的 Route 属性 ^替换

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

`v-link` ^替换

`v-link-active` ^替换

`router.go` ^改变

`hashbang: false` ^移除

`history: true` ^替换

`abstract: true` ^替换

`saveScrollPosition` ^替换

`root` ^换名

`transitionOnLoad` ^移除

`suppressTransitionError` ^移除

`activate` ^替换

`canActivate` ^替换

`deactivate` ^移除

`canDeactivate` ^替换

`canReuse: false` ^移除

`data` ^替换

`$loadingRouteData` ^移除