前言
最近咱们公布了《阿里妈妈又做了新工具,帮你把 Vue2 代码改成 Vue3 的》这个 Vue2 降级工具,上面跟大家分享下咱们如何利用 GoGoCode 对 VueRouter 进行代码降级的。
Vue Router 是什么
贴一个官网介绍:
Vue Router 是 Vue.js 官网的路由管理器。它和 Vue.js 的外围深度集成,让构建单页面利用变得大海捞针
作为 Vue 开发的标配之一,Vue Router 追随 Vue3 同步降级,API 定义与应用上有了一些破坏性的变动。为了实现一键 Vue2 降级 Vue3,咱们把 Vue Router 的转换规则进行了拆解与钻研,上面举几个应用 GoGoCode 的转换场景跟大家分享下:
利用 GoGoCode 降级 Vue Router
GoGoCode 的应用能够 参考这里
1. new Router 变成 createRouter
1.1 API 的变动
Vue Router 不再是一个类,而是一组函数。当初你不必再写 new Router(),而是要调用 createRouter:
// 以前是
// import Router from 'vue-router'
import {createRouter} from 'vue-router'
const router = createRouter({// ...})
1.2 应用 GoGoCode 转换
解决下面 API 的变动,咱们只须要利用 GoGoCode 的 replace
办法,两行代码搞定
// import 形式转换
ast.replace(`import $_$ from 'vue-router'`,
`import * as VueRouter from 'vue-router'`);
// 创立 Router 实例办法转换
ast.replace(`new Router($_$)`, `VueRouter.createRouter($_$)`);
我也来试试:地址
2. 新的 history 配置取代 mode
2.1 API 的变动
mode: 'history'
配置曾经被一个更灵便的 history
配置所取代。依据你应用的模式,你必须用适当的函数替换它:
"history": createWebHistory()
"hash": createWebHashHistory()
-
"abstract": createMemoryHistory()
import {createRouter, createWebHistory} from 'vue-router' // 还有 createWebHashHistory 和 createMemoryHistory createRouter({history: createWebHistory(), routes: [],})
2.2 应用 GoGoCode 转换
VueRouter 中的
mode
配置,能够通过 GoGoCode 的replace
办法,替换成history
配置,如果没有mode
配置,则应用默认配置:history:createWebHashHistory
if (ast.has(`{mode:$_$}`)) { // router 定义中存在 mode 属性,replace 替换 ast.replace(`mode:'history'`, `history: VueRouter.createWebHistory()`); ast.replace(`mode:'hash'`, `history: VueRouter.createWebHashHistory()`); ast.replace(`mode:'abstract'`, `history: VueRouter.createMemoryHistory()`); } else { // router 定义中不存在 mode 属性,默认采纳 createWebHashHistory ast.replace(`{routes:$_$,$$$}`, `{history: VueRouter.createWebHashHistory(),routes:$_$,$$$}`); }
我也来试试:地址
3. 挪动了 base 配置
3.1 API 的变动
base
配置被作为createWebHistory
(其余 history 也一样)的第一个参数传递:import {createRouter, createWebHistory} from 'vue-router' createRouter({history: createWebHistory('/base-directory/'), routes: [],})
3.2 应用 GoGoCode 转换
通过 GoGoCode 通配符号:
$_$
和$$$
, 将base
及其它代码进行乾坤大挪移,能够霎时实现代码片段转移。ast.replace(`{$$$,history: VueRouter.createWebHistory(), base: $_$}`, `{$$$,history: VueRouter.createWebHistory($_$)}`)
我也来试试:地址
4. \<router-view>、\<keep-alive> 和 \<transition>
4.1 API 的变动
transition 和 keep-alive 当初必须通过 v-slot API 在 RouterView 外部 应用:
<router-view v-slot="{Component}"> <transition> <keep-alive> <component :is="Component" /> </keep-alive> </transition> </router-view>
4.2 应用 GoGoCode 转换
GoGoCode 同样能解决 html 代码,咱们将 router-view 节点转移到 transition 外层,同时放弃原来的属性及外部元素构造不变,应用
replace
可霎时实现。ast.replace(`<transition $$$1><router-view $$$2>$$$3</router-view></transition>`, `<router-view v-slot="{Component}" $$$2> <transition $$$1> <component :is="Component" >$$$3</component> </transition> </router-view>`);
我也来试试:地址
最初
这里只是列举了四个比拟典型的 VueRouter 应用场景上的变动,蕴含了 js 和 html 代码转换。其余转换规则能够看下咱们的 GitHub。这些转换规则都是应用了 GoGoCode 之后极大地简化了操作 AST 对象老本,基本上一个
replace
办法就能搞定,遇到代码转换需要十分举荐大家应用 GoGoCode!
如果在应用 GoGoCode 过程中遇到问题能够分割咱们:
github: https://github.com/thx/gogocode/issues
钉钉群:34266233
感谢您的浏览,祝您有美妙的一天!