vue3—组合式API
参考: 哔哩哔哩上 https://www.bilibili.com/video/BV1Zy4y1K7SH?p=136(推荐) 或 李南江老师的课
一、Setup入口函数: https://vue3js.cn/docs/zh/guide/composition-api-setup.html
1、setup
组件选项在创建组件之前执行,一旦 props
被解析,并充当合成 API 的入口点。【所有组合式API都在setup里面】
2、执行 setup
时尚未创建组件实例,因此在 setup
选项中没有 this
。
3、组件中所用到的 数据、方法 等等,均要配置在setup中。
4、setup 中 有两种返回值:
1、若返回一个对象(普通对象),则对象中的属性、方法,在模板中均可以直接使用。即 里面的项 都会 挂在 组件对象【即this】下,组件的其余部分可用。
注意:挂在 this 下的 变量 不一定是 响应式的,vue3中响应式的变量 必须通过给 API 创建。
2、若返回一个渲染函数:则可以自定义渲染内容,即替换组件模板上的渲染内容。【这个 不常用,做了解】
5、注意点:
- 尽量必要与 Vue2.x配置混用
-
-
但在setup中不能访问到Vue2.x配置(data、methos、computed...)。
-
-
- setup 不能 是一个 async函数,因为 async函数 返回值不再是return 的对象,而是promise,模板看不到return 对象中的属性。(后期也可以返回一个Promise实例,但需要Suspense和异步组件的配合)
二、响应式 API
1、ref 函数:
- 作用:定义一个响应式的数据
- 语法: const xxx = ref(initValue)
- 创建一个包含响应式数据的 引用对象(reference对象,简称 ref 对象)。
- JS中操作数据:xxx.value
- 模板中读取数据:不需要 .value,直接xxx就可以。如 <div>{{xxx}}</div>
- 备注:
- 接收的数据可以是:基本类型,也可以是对象类型。
- 基本类型的数据:响应式依然是Object.defineProperty()的get与set完成的。
- 对象类型的数据:内部 “求助”了vue3.0中的一个新函数—reactive函数。
setup () { const name = ref('张三') // 返回一个RefImpl 对象。 结构是 {..., value: ''} console.log(name) function changeName () { name.value = '李四' // ref函数返回的响应式对象,修改时不能直接使用这个变量名来赋值。因为返回来的是一个引用对象,需要通过value 修改值。 } return { name, changeName } }
setup () { const obj = ref({ name: '张三' }) console.log(name) function changeName () { obj.value.name = '李四' // 对象类型里面的值,除了第一层需要.value,其它层不需要再通过 .value 去操作了 } return { obj, changeName } }
重点:正常开发,基本不常用 ref,一般都是使用reactive 方式的。使用ref,要注意加 .value
2、reactive 函数: 【vue3中开发都使用这种方式实现响应式的】
- 作用:定义一个对象类型的响应式数据(基本类型不要用它,要用ref函数)
- 语法:const 代理对象 = reactive(源对象) 接收一个对象(或数组),返回一个代理对象(proxy对象)
- reactive定义的响应式数据是 “深层次的”。(即深层的数据也是响应式的)
- 内部基于ES6的Proxy实现,通过代理对象操作源对象内部数据进行操作。
3、 Vue3.0中的响应式原理
- 实现原理:
- 通过Proxy(代理):拦截对象中任意属性的变化,包括:属性值的读写、属性的添加、属性的删除等。
- 通过Reflect(反射):对被代理对象的属性进行操作。
- MDN文档中描述的Proxy与Reflect:
- Proxy:
- Reflect:
let proxy = new Proxy(data, { // 拦截读取属性值 get (target, prop) { return Reflect.get(target, prop) }, // 拦截设置属性值或添加属性值 set (target, prop, value) { return Reflect.set(target, prop, value) }, deleteProperty (target, prop) { return Reflect.deleteProperty(target, prop) } }) proxy.name = 'tom'
4、reactive对比ref
- 从定义数据角度对比:
- ref用来定义:基本类型数据。
- reactive用来定义:对象(或数组)类型数据。
- 备注:ref也可以用来定义对象(或数组)类型数据,他内部会自动通过reactive转为代理对象。
- 从原理角度对比:
- ref通过Object.defineProperty() 的 get 与 set 来实现响应式(数据劫持)。
- reactive通过使用Proxy来实现响应式(数据劫持),并通过Reflect操作源对象内部的数据。
- 从使用角度对比:
- ref定义的数据:操作数据需要 .value,读取数据时模板中直接读取不需要 .value 。
- reactive定义的数据:操作数据与读写数据,均不需要 .value 。
5、 setup的两个注意点
- setup执行的时机
- 在beforeCreate之前执行一次,this是undefined。
- setup的参数
- props:值为对象,包含 组件外部传递过来,且组件内部声明接受了的属性。
- context:上下文对象
- attrs:值为对象,包含组件外部传递过来,但没有在props配置中声明的属性,相当于vue2中的 this.$attrs。
- slots:收到的插槽内容,相当于vue2中的 this.$slots。
- emit:分发自定义事件的函数,相当于vue2中的 this.$emit。
【说明:props 和 contex.attrs 把父组件传递过来的属性全部接收了】
6、计算属性与监视
-
computed函数
- 与Vue2.x中computed配置功能一致
- 写法
import { computed } from 'vue' setup(){ //数据 let person = reactive({ firstName:'张', lastName:'三' }) //计算属性——简写(没有考虑计算属性被修改的情况) /* person.fullName = computed(()=>{ return person.firstName + '-' + person.lastName }) */ //计算属性——完整写法(考虑读和写) person.fullName = computed({ get(){ return person.firstName + '-' + person.lastName }, set(value){ const nameArr = value.split('-') person.firstName = nameArr[0] person.lastName = nameArr[1] } }) }
-
watch函数
- 与Vue2.x中的watch配置功能一致
- 两个小 ”坑“:
- 监视reactive定义的响应式数据时,oldValue无法正确获取、强制开启了深度监视(deep配置失效)。
- 监视reactive定义的响应式数据中某个属性时,deep配置有效。
import { ref, reactive, watch } from 'vue' setup(){ const sum = ref(0) const msg = ref('你好啊') const person = reactive({ name: '张三', age: 18, job: { j1: { salary: 20 } } }) // 情况一:监视ref所定义的一个响应式数据 watch(sum, (newValue, oldValue) => { console.log('sum变了', newValue, oldValue) }, { immediate: true }) // 情况二:监视ref所定义的多个响应式数据 watch([sum, msg], (newValue, oldValue) => { console.log('sum或msg变了', newValue, oldValue) }, { immediate: true }) /* 情况三:监视reactive所定义的一个响应式数据的全部属性 1.注意:此处无法正确的获取oldValue 【这点要特别注意】 2.注意:强制开启了深度监视(deep配置无效) */ watch(person, (newValue, oldValue) => { console.log('person变化了', newValue, oldValue) }, { deep: false }) // 此处的deep配置无效 // 情况四:监视reactive所定义的一个响应式数据中的某个属性 watch(() => person.name, (newValue, oldValue) => { console.log('person的name变化了', newValue, oldValue) }) // 情况五:监视reactive所定义的一个响应式数据中的某些属性 watch([() => person.name, () => person.age], (newValue, oldValue) => { console.log('person的name或age变化了', newValue, oldValue) }) // 特殊情况 watch(() => person.job, (newValue, oldValue) => { console.log('person的job变化了', newValue, oldValue) }, { deep: true }) // 此处由于监视的是reactive素定义的对象中的某个属性,所以deep配置有效 }
-
watchEffect 函数
- watch的套路是:既要指明监视的属性,也要指明监视的回调。
- watchEffect的套路是:不用指明监视哪个属性,监视的回调中用到哪个属性,那就监视哪个属性。
- watchEffect有点像computed:
- 但computed注重的计算出来的值(回调函数的返回值),所以必须要写返回值。
- 而watchEffect更注重的是过程(回调函数的函数体),所以不用写返回值。
//watchEffect所指定的回调中用到的数据只要发生变化,则直接重新执行回调。 watchEffect(()=>{ const x1 = sum.value const x2 = person.age console.log('watchEffect配置的回调执行了') })
7、生命周期钩子: https://vue3js.cn/docs/zh/guide/composition-api-lifecycle-hooks.html
下面只讲组合式API中的生命周期
-
-
mounted
=======>onMounted
-
beforeUpdate
===>onBeforeUpdate
-
updated
=======>onUpdated
-
beforeUnmount
==>onBeforeUnmount
-
unmounted
=====>
8、
-
-
类似于vue2.x中的mixin。
-
【注意:hook文件,一般以 use开头来命令比较好,这样看到这个文件就知道是hook文件了】
9、toRef :https://cn.vuejs.org/api/reactivity-utilities.html#toref
-
作用:创建一个 ref 对象,其value值指向另一个对象中的某个属性。
-
语法:
const name = toRef(person,'name')
-
应用: 要将响应式对象中的某个属性单独提供给外部使用时。
-
扩展:
toRefs
与toRef
功能一致,但可以批量创建多个 ref 对象,语法:toRefs(person)
三、
-
-
shallowRef:只处理基本数据类型的响应式, 不进行对象的响应式处理。
-
什么时候使用?
-
如果有一个对象数据,结构比较深, 但变化时只是外层属性变化 ===> shallowReactive。
-
-
2、readonly 与 shallowReadonly
-
-
shallowReadonly:让一个响应式数据变为只读的(浅只读)。
-
3、toRaw 与 markRaw
-
-
作用:将一个由
reactive
生成的响应式对象转为普通对象。 -
使用场景:用于读取响应式对象对应的普通对象,对这个普通对象的所有操作,不会引起页面更新。
-
-
markRaw:
-
作用:标记一个对象,使其永远不会再成为响应式对象。
-
应用场景:
-
有些值不应被设置为响应式的,例如复杂的第三方类库等。
-
-
-
4、customRef
-
-
<template> <input type="text" v-model="keyword"> <h3>{{keyword}}</h3> </template> <script> import {ref,customRef} from 'vue' export default { name:'Demo', setup(){ // let keyword = ref('hello') //使用Vue准备好的内置ref //自定义一个myRef function myRef(value,delay){ let timer //通过customRef去实现自定义 return customRef((track,trigger)=>{ return{ get(){ track() //告诉Vue这个value值是需要被“追踪”的 return value }, set(newValue){ clearTimeout(timer) timer = setTimeout(()=>{ value = newValue trigger() //告诉Vue去更新界面 },delay) } } }) } let keyword = myRef('hello',500) //使用程序员自定义的ref return { keyword } } } </script>
5、provide 与 inject
-
-
套路:父组件有一个
provide
选项来提供数据,后代组件有一个inject
选项来开始使用这些数据 -
具体写法:
-
setup(){ ...... let car = reactive({name:'奔驰',price:'40万'}) provide('car',car) ...... }
- 后代组件中:
setup(props,context){ ...... const car = inject('car') return {car} ...... }
-
6、响应式数据的判断
-
-
isReactive: 检查一个对象是否是由
reactive
创建的响应式代理 -
isReadonly: 检查一个对象是否是由
readonly
创建的只读代理 -
isProxy: 检查一个对象是否是由
reactive
或者readonly
四、Composition API 的优势
1、Options API 存在的问题
关注点分离:使用传统OptionsAPI中,新增或者修改一个需求,就需要分别在data,methods,computed里修改 。
五、新的组件
1、
-
-
在Vue3中: 组件可以没有根标签, 内部会将多个标签包含在一个Fragment虚拟元素中
-
2、Teleport
<teleport to="移动位置"> <div v-if="isShow" class="mask"> <div class="dialog"> <h3>我是一个弹窗</h3> <button @click="isShow = false">关闭弹窗</button> </div> </div> </teleport>
3、Suspense
-
-
使用步骤:
-
import {defineAsyncComponent} from 'vue' const Child = defineAsyncComponent(()=>import('./components/Child.vue'))
<template> <div class="app"> <h3>我是App组件</h3> <Suspense> <template v-slot:default> <Child/> </template> <template v-slot:fallback> <h3>加载中.....</h3> </template> </Suspense> </div> </template>
-
六、其它
1、
-
//注册全局组件 Vue.component('MyButton', { data: () => ({ count: 0 }), template: '<button @click="count++">Clicked {{ count }} times.</button>' }) //注册全局指令 Vue.directive('focus', { inserted: el => el.focus() }
-
-
-
将全局的API,即:
Vue.xxx
调整到应用实例(app
-
3.x 实例 API (app ) | |
---|---|
Vue.config.xxxx | app.config.xxxx |
Vue.config.productionTip | 移除 |
Vue.component | app.component |
Vue.directive | app.directive |
Vue.mixin | app.mixin |
Vue.use | app.use |
Vue.prototype |
2、其它改变
-
-
过度类名的更改:
-
.v-enter, .v-leave-to { opacity: 0; } .v-leave, .v-enter-to { opacity: 1; }
- Vue3.x写法
.v-enter-from, .v-leave-to { opacity: 0; } .v-leave-from, .v-enter-to { opacity: 1; }
-
-
-
<my-component v-on:close="handleComponentEvent" v-on:click="handleNativeClickEvent" />
- 子组件中声明自定义事件
<script> export default { emits: ['close'] } </script>
-
过滤器虽然这看起来很方便,但它需要一个自定义语法,打破大括号内表达式是 “只是 JavaScript” 的假设,这不仅有学习成本,而且有实现成本!建议用方法调用或计算属性去替换过滤器。
- ...