常用 Composition API

setup()

理解：Vue3.0中一个新的配置项，值为一个函数。
setup是所有Composition API（组合API）的“表演舞台”。
组件中所用到的：数据、方法等，均配置在setup中。
setup函数的两种返回值：
1. 若返回一个对象，则对象中的属性、方法，在模板中均可直接使用。（重点！）
2. 若返回一个渲染函数：则可以自定义渲染内容。（了解）
注意：
1. 尽量不要与Vue2.x配置混用
  - Vue2.x配置（data、methods、computed……）中可以访问到setup中的属性、方法。
  - 但在setup中不能访问到Vue2.x配置。
  - 若有重名，setup优先。
2. setup不能是一个async函数，因为返回值不再是return的对象，而是promise，模板看不到return对象中的属性。（【注】：后期也可以返回一个promise实列，但需要Suspense和异步引入组件配合）

reactive与ref对比

定义数据：
- ref：定义基本类型数据。
- reactive：定义对象（或数组）类型数据。
- [备注]：ref也可以用来定义对象（或数组）类型数据，它内部会自动通过reactive来代理对象。
原理：
- ref通过Object.defineProperty()的get()与set()来实现响应式（数据劫持）。
- reactive通过使用Proxy来实现响应式（数据劫持），并通过Reflect操作源对象内部的数据。
使用：
- ref定义的数据：操作数据需要.value，读取数据时模板中直接读取而不用.value。
- reactive定义的数据：操作与读取均不需要.value。

setup的两个注意点

执行的时机
- 在beforeCreate之前执行一次，this是undefined。
参数
- props：值为对象，包含：组件外部传递过来，且组件内部声明接收的属性。
- context：上下文对象
  - attrs：值为对象，包含：组件外部传递过来，但没有在props配置中声明的属性，相当于this.$attrs。
  - slots：收到的插槽内容，相当于this.$slots。
  - emit：分发自定义事件的函数，相当于this.$emit，需要在emits中声明。

计算属性与监视

computed函数

与Vue2.x中computed配置功能一致
写法

import {computed} from 'vue'

setup() {
    ...
    // 计算属性 -- 简写（没有考虑被修改的情况）
    let fullName = computed(() => {
        return person.firstName + ' ' + person.lastName 
    })

    // 计算属性 -- 完整
    let fullName = computed({
        get() {
            return person.firstName + ' ' + person.lastName 
        },
        set(value) {
            const nameArr = value.split(' ')
            person.firstName = nameArr[0]
            person.lastName = nameArr[1]
        }
    })
    
    // 返回
    return {
        fullName
    }    
}

watch

与Vue2.x中watch配置功能一致
两个小“坑”：
- 监视reactive定义的响应式数据时：oldValue无法正确获取、且强制开启了深度监视（即deep配置无效）。
- 监视reactive定义的响应式数据中的某个属性时：deep配置生效。

// 数据
let sum = ref(0)
let msg = ref("Hello")
let person = reactive({
    name: 'zhl',
    age: 18,
    job: {
        j1: {
            salary: 20
        }
    }
})

// 情况一：监视ref定义的一个响应式数据
watch(sum, (newValue, oldValue) => {
    console.log('sum变了', newValue, oldValue)
}, {immediate: true}) 
watch(msg, (newValue, oldValue) => {
    console.log('msg变了', newValue, oldValue)
})

// 情况二：监视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})

// 情况四：监视reactive定义的一个响应式数据中的某个属性
watch(() => person.age, (newValue, oldValue) => {
    console.log('person变了', newValue, oldValue)
})

// 情况五：监视reactive定义的一个响应式数据中的某些属性
watch([() => person.name, () => person.age], (newValue, oldValue) => {
    console.log('person变了', newValue, oldValue)
})

// 特殊情况
watch(() => person.job, (newValue, oldValue) => {
    console.log('person变了', newValue, oldValue)
}, {deep: true})

watchEffect函数

watch的套路是：既要指明监视的属性，也要指明监视的回调。
watchEffect的套路是：不用指明监视哪个属性，监视的回调中用到哪个属性，就监视哪个属性。
watchEffect有点像computed：
- 但computed注重的计算出来的值（回调函数的返回值），所以必须要写返回值。
- 而watchEffect更注重的是过程（回调函数的函数体），所以不用写返回值。

watchEffect(() => {
    const x1 = sum.value
    const x2 = person.age
    console.log('watchEffect配置的回调执行了')
})

生命周期

Vue3.0可以继续使用Vue2.x中的生命周期钩子，但有两个被更名：
- beforeDestroy改名为beforeUnmount
- destroyed改名为unmounted
Vue3.0也提供了Composition API形式的生命周期钩子，与Vue2.x中钩子对应关系如下：
- beforeCreate=====>setup()
- created=====>setup()
- beforeMount=====>onBeforeMount
- mounted=====>onMounted
- beforeUpdate=====>onBeforeUpdate
- updated=====>onUpdated
- beforeUnmount=====>onBeforeUnmount
- unmounted=====>onUnmounted

setup() {
    console.log('----setup-----')    
    // 通过组合式API的形式去使用生命周期钩子
    onBeforeMount(() => {
        console.log('----onBeforeMount-----')
    })
    onMounted(() => {
        console.log('----onMounted-----')
    })
    onBeforeUpdate(() => {
        console.log('----onBeforeUpdate-----')
    })
    onUpdated(() => {
        console.log('----onUpdated-----')
    })
    onBeforeUnmount(() => {
        console.log('----onBeforeUnmount-----')
    })
    onUnmounted(() => {
        console.log('----onUnmounted-----')
    })
},
// 通过配置项的形式使用生命周期钩子
/* 
beforeCreate() {},
created() {},
beforeMount() {},
mounted() {},
beforeUpdate() {},
updated() {},
beforeUnmount() {},
unmounted() {}, 
*/

自定义hook函数

本质：把setup函数中使用的Composition API进行了封装。
类似于vue2.x中的mixin。
自定义hook的优势：复用代码，让setup中的逻辑更清楚易懂。

// 新建 @/hooks/usePoint.js
import { onBeforeUnmount, onMounted, reactive } from 'vue'
export default function () {
    // 实现鼠标点击“打点”相关的数据
    let point = reactive({
        x:0,
        y:0
    })

    // 鼠标点击，保存点击位置
    function savePoint(event) {
        console.log(event.pageX, event.pageY)
        point.x = event.pageX
        point.y = event.pageY
    }

    // 生命周期钩子
    onMounted(() => {
        // 添加点击监听
        window.addEventListener('click', savePoint)
    })
    onBeforeUnmount(() => {
        // 移除点击监听
        window.removeEventListener('click', savePoint)
    })

    // 返回数据
    return point
}

// 在模板vue文件中
<template>
    <div>
        我是Test组件        
        <h2>当前点击时鼠标的坐标为：x:{{point.x}}, y:{{point.y}}</h2>
    </div>
</template>
<script>
// 引入hook函数
import usePoint from '@/hooks/usePoint'
export default {
    name: 'TestVue',
    setup() {
        // 调用hook函数返回的数据
        const point = usePoint()
        return {point}
    }
}
</script>

toRef

作用：创建一个ref对象，其value值指向另一个对象中的某个属性。
语法：const name = toRef(person, 'name')
应用：要将响应式对象中的某个属性单独提供给外部使用时。
扩展：toRefs与toRef功能一致，但可以批量创建多个ref对象，语法：toRefs(person)

import { reactive, toRef, toRefs } from 'vue'
export default {
    name: 'DemoVue',
    setup() {
        // 数据
        let person = reactive({
            name: 'zhl',
            age: 18,
            job: {
                j1: {
                    salary: 20
                }
            }
        })

        const name2 = toRef(person, 'name')
        console.log('@@', name2)

        const x = toRefs(person)
        console.log(x)

        // 返回
        return {
            person,
            /* name: toRef(person, 'name'),
            age: toRef(person, 'age'),
            salary: toRef(person.job.j1, 'salary') */
            ...toRefs(person)
        }
    }
}

其他 Composition API

shallowReactive 与 shallowRef

shallowReactive：只处理对象最外层属性的响应式（浅响应式）。
shallowRef：只处理基本数据类型的响应式，不进行对象的响应式处理。
什么时候用？
- 如果有一个对象数据，结构比较深，但变化时只是最外层属性变化 ===> shallowReactive。
- 如果有一个对象数据，后续功能不会修改该对象中的属性，而是生成新的对象来替换 ===> shallowRef。

readonly 与 shallowReadonly

readonly：让一个响应式数据变为只读（深只读）。
shallowreadonly：让一个响应式数据变为只读的（浅只读）。
应用场景：不希望数据被修改时。

toRaw 与 markRaw

toRaw：
- 作用：将一个由reactive生成的响应式对象转化为普通对象。
- 使用场景：用于读取响应式对象对应的普通对象，对这个普通对象的所有操作，不会引起页面更新。
markRaw：
- 作用：标记一个对象，使其永远不会再成为响应式对象。
- 应用场景：
  1. 有些值不应被设置为响应式的，例如复杂的第三方类库等。
  2. 当渲染具有不可变数据源的大列表时，跳过响应式转换可以提高性能。（例如纯展示的列表等）

customRef

作用：创建一个自定义的ref，并对其依赖项跟踪和更新出发进行显式控制。

<template>
    <div> 
        <input type="text" v-model="keyword">  
        <h3>{{keyword}}</h3>
    </div>
</template>

<script>
import { customRef } from 'vue';
// import { ref } from 'vue'
export default {
    name: 'App',
    setup() {
        // 自定义ref：myRef
        function myRef(value, delay) {
            console.log('-----myRef----')
            let timer
            return customRef((track, trigger) => {
                return {
                    get(){
                        console.log(`@@ get---- ${value}`)
                        track() //通知vue追踪value的变化（提前和get商量，让它认为value有用）
                        return value
                    },
                    set(newValue){
                        console.log(`## set---- ${newValue}`)
                        clearTimeout(timer)
                        timer = setTimeout(() => {
                            value = newValue    //修改值
                            trigger()   //通知vue重新解析模板
                        }, delay)                        
                    }
                }
            })
        }

        // let keyword = ref('Hello')   //使用Vue提供的ref
        let keyword = myRef('Hello', 500)    //使用自定义的ref
        return {keyword}
    }
};
</script>

provide 与 inject

作用：实现祖与后代组件间通信。
套路：祖组件有一个provide选项来提供数据，后代组件有一个inject选项来使用这些数据。

具体写法：

祖组件中：

setup() {
    ...
    let car = reactive({
        name: '奔驰',
        price: '40W'
    })
    provide('carData', car) //给自己的后代组件传递数据carData
    ...
}

后代组件中：

setup() {
    ...
    const car = inject('carData') //接收父组件传递的数据carData
    ...
    return {car}
}

响应式数据的判断

isRef：检查一个值是否为一个ref对象。
isReactive：检查一个对象是否是由reactive创建的响应式代理。
isReadonly：检查一个对象是否是由readonly创建的只读代理。
isProxy：检查一个对象是否是由reactive或readonly方法创建的代理。

新的组件

Fragment

Vue2中：组件必须有一个根标签。
Vue3中：组件可以没有根标签，内部会将多个标签包含在一个Fragment虚拟元素中。
好处：减少标签层级，减小内存占用。

Teleport

将组件模板的DOM部分移动到其他组件或Vue app之外的其他位置。

<div>
    <button @click="isShow=true">点我弹窗</button>
    <teleport to='body'>
    <!--将弹窗定位在body中-->
        <div class="mask" v-if="isShow">
            <div class="dialog">
                <h4>我是一个弹窗</h4>
                <button @click="isShow=false">关闭弹窗</button>
            </div>
        </div>
    </teleport>   
    <teleport to="#modal"></teleport>
</div>

Suspense

等待异步组件时渲染一些额外内容，让应用有更好的用户体验
使用步骤：
1. 异步引入组件
2. 使用Suspense包裹组件，并配置好v-slot:default与v-slot:fallback插槽内容

// App.vue
<template>
    <div class="app">
        <h2>我是App组件</h2>
        <Suspense>
            <template v-slot:default>
                <!-- 正确返回组件 -->
                <Child></Child> 
            </template>
            <template v-slot:fallback>
                <!-- 出现错误，未能获取正确返回 -->
                <h4>稍等，加载中···</h4>
            </template>                   
        </Suspense>
    </div>
</template>
<script>
// import Child from './components/Child.vue' //静态引入
import { defineAsyncComponent } from "vue" //异步引入 
const Child = defineAsyncComponent(() => import('./components/Child.vue'))
export default {
    name: "App",
    components: { Child }
}
</script>

//Child.vue
<template>
    <div class="child">
        <h3>我是Child组件</h3>
        {{sum}}
    </div>
</template>
<script>
import { ref } from 'vue'
export default {
    name: 'ChildVue',
    async setup() {
        let sum = ref(0)
        let p = new Promise((resolve) => {
            setTimeout(() => {
                resolve({sum})
            }, 1000);
        })
        return await p
    }
}
</script>

全局API的转移

将全局的API，即Vue.xxx调整到应用实例app上

2.x全局API（`Vue`）	3.x实例API（`app`）
Vue.config.xxx	app.config.xxx
Vue.config.productionTip	`移除`
Vue.component	app.component
Vue.directive	app.directive
Vue.mixin	app.mixin
Vue.use	app.use
Vue.prototype	app.config.globalProperties

与Vue2.x的改变

data选项始终被声明为一个函数。

过渡类名的更改：

Vue2.x写法：

.v-enter, .v-leave-to {opacity:0}
.v-leave, .v-enter-to {opacity:1}

Vue3.x写法：

.v-enter-from, v-leave-to {opactiy: 0}
.v-leave-from, v-enter-to {opactiy: 1}

移除keyCode作为v-on的修饰符，同时也不再支持config.keyCodes

移除``v-on.native修饰符

父组件中绑定事件

<my-component
    v-on:close="handleComponentEvent"
    v-on:click="handleNativeClickEvent"
/>

子组件MyComponent中声明自定义事件

<script>
    export default {
        emits: ['close']
    }
</script>

移除过滤器（filter）

过滤器虽然看起来很方便，但它需要一个自定义语法，打破大括号内表达式是“只是JavaScript”的假设，不仅有学习成本，还有实现成本！建议用方法调用或计算属性去替换过滤器。

vue3

常用 Composition API

setup()

reactive与ref对比

setup的两个注意点

计算属性与监视

computed函数

watch

watchEffect函数

生命周期

自定义hook函数

toRef

其他 Composition API

shallowReactive 与 shallowRef

readonly 与 shallowReadonly

toRaw 与 markRaw

customRef

provide 与 inject

响应式数据的判断

新的组件

Fragment

Teleport

Suspense

全局API的转移

与Vue2.x的改变