前言
Vue3已经发布很长一段时间了,虽然早就用上了框架,但是很多人依旧保持着Vue2的思维习惯,导致大家在实际开发中并没有感觉到提升,属实是新瓶装旧酒。我们应该意识到这并不仅仅是一个数字大版本的迭代,而是一次全新的开发体验。
让我们一起看看在使用Vue3开发时,应该在哪些地方做出改变?
正文
使用<script setup>
如果是从Vue2转到Vue3,我们很熟悉的一种写法是选项式API写法。
{{ title }}
<script>
import CompA from './CompA.vue'
export default {
components: { CompA },
setup (props, context) {
return {}
},
methods: {
doSomething () {
// do something
},
},
}
</script>
通过export default导出一个对象,内部的data,methods,watch都可以使用,this依然可以保留,并指向vue,setup中如果想用props、emit等,通过参数传递。在setup中可以直接使用新写法,组件通过components进行引入。可以极大的还原Vue2的用法,如果团队的组件库是使用Vue2写的,可以用很小的成本就改造完成。
为了更好的类型推导,vue还提供了defineComponent方法。
export default defineComponent({
components: { CompA },
setup (props, context) {
// do something
},
})
但其实官方并不推荐这种写法,这种写法仅仅是为了兼容旧代码,这也是你感觉Vue3没有提升的很大一方面因素。就像是iPhone更新,当外观有变化时你才会觉得是大更新,系统升级个IOS18,你觉得卵用没用。所以更好的方式应该是<script setup>标签对的写法。
<script setup lang="ts">
import { onMounted, ref } from 'vue'
const title = ref('')
onMounted(() => {
title.value = 'Demo'
})
</script>
{{ title }}
你会发现有很多核心的变化,首先不再需要export导出了,标签对内直接就是一个setup环境。ref可以直接写,也没有了methods,你写一个就是一个方法,直接就可以绑定。为什么呢?官方不是说所有的值都需要return出去吗?放心,@vue/compiler-sfc帮你解决了这些烦恼。
其次这种写法是去this化的,比如以往我们调用router都是this.$router这么使用,而现在你需要引入useRouter,可以更好的分辨来源。对ts也更友好。
import { useRouter } from 'vue-router'
const router = useRouter()
组件使用也更方便,直接引入即可。
<script setup lang="ts">
import CompA from './CompA.vue'
</script>
同名简写
以往我们绑定一个值需要这样:
<script>
export default {
data () {
return {
id: 'container',
title: '标题',
}
},
}
</script>
而现在变得极其简单,尤其是Vue升级到v3.4.x以上之后,因为它增加了同名简写。
<script setup lang="ts">
const id = ref('container')
const title = ref('标题')
</script>
怎么样,有没有觉得非常优雅,不过比较可惜的是这个写法esLint目前还不支持,会报异常,需要在.eslintrc中忽略一下。
"rules": {
"vue/valid-v-bind": "off"
}
拒绝mixins
我们之前Vue2的模版中有很多的mixins,而且不乏有全局引入的mixins,在迁移模板时,也需要一起处理,我看到官方也有案例,有mixins的,还有extends的。
const mixin = {
created() { console.log(1) }
}
createApp({
created() { console.log(2) },
mixins: [mixin]
})
但是均都对组合式API不友好,因为mixin内部有不少调用this内部环境的地方,很难在<script setup>中使用,而且mixins最大的问题就是,你无法溯源,别人在某个犄角旮旯引入一个全局mixins,你根本找不到,而且也对类型推导极其不友好。所以建议使用组合式函数代替。比如我们之前有一个NavBar的mixins,里面处理了很多逻辑,就可以用组合式函数进行封装。
import { onMounted, ref } from 'vue'
const commonProps = {}
const useNavbar = () => {
const navbarProps = ref({})
const setNavbar = (newProps?: any) => {
navbarProps.value = {
...navbarProps.value,
...newProps || {},
...commonProps,
}
if (navbarProps.value.title && typeof document !== 'undefined') {
document.title = navbarProps.value.title
}
}
onMounted(() => {
// init
})
return {
navbarProps,
setNavbar,
}
}
export default useNavbar
在使用时引用进来即可,而且只要你调用了useNavbar,内部的onMounted也会执行,非常方便。
import useNavbar from './useNavbar'
const { navbarProps, setNavbar} = useNavbar()
减少全局变量
之前在Vue2时,我们经常会将一些常用属性挂载在Vue.prototype原型上,方便内部用this.xxx使用。比如我们会把Request挂载上去,Vue.prototype.$request = Request。我们发送请求时直接this.$request即可,很方便。其实很多Vue2的依赖库都是这么写的,比如vue-router,就是在install中将$router写为了全局变量,在我们使用Vue.use(Router)后,方便我们使用。
而在Vue3中也有替代方案,
app.config.globalProperties.$request = Request。 但是在使用时就比较麻烦了,因为没有this环境,需要从实例上取。
import { getCurrentInstance } from 'vue'
const $this = getCurrentInstance()?.appContext.config.globalProperties
$this?.$request.post('/url', {})
很深的API,既然这么深,我想我封装一下吧。
// vueThis.ts
import { getCurrentInstance } from 'vue'
export default getCurrentInstance()?.appContext.config.globalProperties
// 使用时
import vueThis from './vueThis'
vueThis.$request.post('/url',{})
但是你说气人不,getCurrentInstance还要识别调用的时机,你直接赋值,相当于引入时就运行了,这个时候还没实例,你还得闭包包一下,调用也不好看。
// vueThis.ts
export default () => {
return getCurrentInstance()?.appContext.config.globalProperties
}
// 使用时
import vueThis from './vueThis'
const $this = vueThis()
$this.$request.post('/url',{})
而且不光如此,你挂载全局变量,想要有类型推导,你还要在vue-runtime-core.d.ts把类型告诉人家,才好用。特别不优雅。
import request from '@host/request'
declare module '@vue/runtime-core' {
interface ComponentCustomProperties {
$request: typeof request
}
}
所以依旧建议使用组合式函数进行封装,清晰又明了。
// useRequest.ts
export default () => {
const get = async (uri: string, params: any = {}) => {
return await Request.get(uri, params)
}
const post = async (uri: string, params: any = {}) => {
return await Request.post(uri, params)
}
return {
get,
post,
}
}
// 使用时
import useRequest from './useRequest'
const { post } = useRequest()
post('/url',{})
一个use只办一件事
Vue2始终是以页面为单位进行思考的,即一个vue只办一件事,至于提供的mixin也好,props也好,emit也好,都是为了服务这个vue本身的,所有也是为什么简单页面vue最好用。
但是伴随着一个vue的功能越来越多,代码也就越来越复杂,就变成了左图Options API的样子,再加上全局属性的乱加,mixins的乱用,组件的乱引,整体也变得越来越冗余,最终变成了大家吐槽的对象。
Vue3推出的组合式函数的概念,借鉴了React Hooks的写法,将原本一个vue一件事抽象成一个vue几件事,再用函数进行打包。最终就是Composition API的样子。所以我们开发时就应该顺应Vue3的思维:一个use只办一件事。
举几个案例:
- useRequest --> 这个use只管请求,配置也好,初始化也好,都在内。
- useNavbar --> 这个函数只管navBar
- useDevice --> 这个函数只管设备相关的内容
- useLoad --> 这个函数只管加载
抛弃index命名
Vue2常规的项目路径是这样的:
- pages
- home
- img
- components
- CompA.vue
- CompB.vue
- index.vue
- rule
- index.vue
已经很整洁了,但是我建议改成这样:
- pages
- home
- img
- components
- CompA.vue
- CompB.vue
- Home.vue
- rule
- Rule.vue
为什么呢?因为Vue3有个特性,在<script setup>模式下,无法指定组件名称,也就意味着路由名称也无法指定,所以文件名就是组件名,就是路由名称,所以建议全部使用语义化文件名。
如果用index,他的路由名称就会是index,非常不友好。比如你在区分哪些需要使用KeepAlive时,你就无法识别。
作者:自在的小李子
链接:
https://juejin.cn/post/7413335608464769063