前言
之前使用vue3都是在公司的基建项目中,为了快速达到目的,把以前vue2的模板拿来简单改改就直接用了,所以项目中用法特别乱,比如:状态管理依旧用的vuex,各种类型定义全是any,有些代码是选项式API,有些代码是组合式API...
最近终于有时间推动一下业务项目使用vue3了。作为极简主义的我,始终奉行少即是多,既然是新场景,一切从新,从头开始写模版:
使用最新的vue3版本v3.5.x。
所有使用的内部库全部生成ts类型并引入到环境中。
将所有的mixins重写,包装成组合式函数。
将以前的vue上的全局变量挂载到app.config.globalProperties。
全局变量申明类型到vue-runtime-core.d.ts中,方便使用。
全部使用setup语法,使用标签
使用pinia作为状态管理。
pinia使用
等等,pinia?好用吗?打开官方文档研究了下,官方优先推荐的是选项式API的写法。
调用defineStore方法,添加属性state, getters, actions等。
export const useCounterStore = defineStore('counter', { state: () => ({ count: 0, name: 'Eduardo' }), getters: { doubleCount: (state) => state.count * 2, }, actions: { increment () { this.count++ }, },})
使用的时候,调用useCounterStore即可。
import { useCounterStore } from '@/stores/counter'import { computed } from 'vue'
const store = useCounterStore()setTimeout(() => { store.increment()}, 1000)const doubleValue = computed(() => store.doubleCount)
看上去还不错,但是我模版中全部用的是组合式写法,肯定要用组合式API,试着写了个demo,ref就是选项式写法中的state,computed就是选项式中的getters,function就是actions。
// useTime.tsimport { defineStore } from 'pinia'import { computed, ref } from 'vue'import vueConfig from '../../../common/config/vueConfig'import * as dayjs from 'dayjs'
export default defineStore('time', () => { const $this = vueConfig() const time = ref<number>() const timeFormat = computed(() => dayjs(time.value).format('YYYY-MM-DD HH:mm:ss')) const getSystemTime = async () => { const res = await $this?.$request.post('/system/time') time.value = Number(res.timestamp) } return { timeFormat, getSystemTime }})
调用时解构赋值,就可以直接用了。
// index.vueimport { onMounted } from 'vue'import useTime from './use/useTime'
const { timeFormat, getSystemTime } = useTime()onMounted(async () => { // 请求 await getSystemTime() console.log('当前时间:', timeFormat)})
优雅了很多,之前用vuex时还有个问题,storeA中的state、actions等,会在storeB中使用,这一点pinia文档也有说明,直接在storeB调用就好了,比如我想在另一个组件中调用上文中提到的timeFormat。
defineStore('count', () => { const count = ref<number>(0) const { timeFormat } = useTime() return { count, timeFormat, }})
怎么看着这么眼熟呢,这不就是组合式函数吗?为什么我要用defineStore再包一层呢?试一试不用pinia,看能不能完成状态管理。
组合式函数
直接添加一个useCount.ts文件,申明一个组合式函数。
// useCount.tsimport { computed, ref } from 'vue'
const useCount = () => { const count = ref<number>(0) const doubleCount = computed(() => { return count.value * 2 }) const setCount = (v: number) => { count.value = v } return { count, doubleCount, setCount, }}export default useCount
使用时直接解构申明,并使用。
import useCount from './use/useCount'
const { count, setCount } = useCount()onMounted(async () => { console.log('count', count.value) // 0 setCount(10) console.log('count', count.value) // 10 })
最大的问题来了,如何在多个地方共用count的值呢,这也是store最大的好处,了解javascript函数机制的我们知道useCount本身是一个闭包,每次调用,里面的ref就会重新生成。count就会重置。
import useCount from './use/useCount'
const { count, setCount } = useCount()const { doubleCount } = useCount()
onMounted(async () => { console.log('count', count.value, doubleCount.value) // 0 0 setCount(10) console.log('count', count.value, doubleCount.value) // 10 0 })
这个时候doubleCount用的并不是第一个useCount中的count,而是第二个重新生成的,所以setCount并不会引起doubleCount的变化。
怎么办呢?简单,我们只需要把count的声明暴露在全局环境中,这样在import时就会申明了,调用函数时不会被重置。
import { computed, ref } from 'vue'
const count = ref<number>(0)const useCount = () => { const doubleCount = computed(() => { return count.value * 2 }) const setCount = (v: number) => { count.value = v } return { count, doubleCount, setCount, }}export default useCount
当我们多次调用时,发现可以共享了。
import useCount from './use/useCount'
const { count, setCount } = useCount()const { doubleCount } = useCount()
onMounted(async () => { console.log('count', count.value, doubleCount.value) // 0 0 setCount(10) console.log('count', count.value, doubleCount.value) // 10 20 })
但是这个时候count是比较危险的,store应该可以保护state不被外部所修改,很简单,我们只需要用readonly包裹一下返回的值即可。
import { computed, readonly, ref } from 'vue'
const count = ref<number>(0)const useCount = () => { const doubleCount = computed(() => { return count.value * 2 }) const setCount = (v: number) => { count.value = v } return { // readonly可以确保引用对象不会被修改 count: readonly(count), doubleCount, setCount, }}export default useCount
总结
经过我的努力,vue3又减少了一个库的使用,我就说不需要用pinia,不过放弃pinia也就意味着放弃了它自带的一些方法store.$state,store.$patch等等,这些方法实现很简单,很轻松就可以手写出来,如果你是这些方法的重度用户,保留pinia也没问题,如果你也想代码更加精简,赶紧尝试下组合式函数吧。
领取专属 10元无门槛券
私享最新 技术干货