image

Vue3.x 官网

一、Composition API 简介

Vue2 时的方式在代码很少的时候，逻辑结构还是蛮清晰的，但是随着组件功能越来越多，代码量越来越大，整体内容全部放在其中肯定会显得臃肿。因为每个功能模块的代码会散落分布在各个位置，让整个项目的内容难以阅读和维护。如下图：

image

而到了 Vue3，它会根据逻辑功能来进行组织，把同一个功能的不同代码都放在一起，或者把它们单独拿出来放在一个函数中，所以 Composition API 又被称为基于函数组合的API：

image

1. setup 函数

setup 函数是 Vue3 中新增的函数，它是我们在编写组件时，使用 Composition API 的入口。
同时它也是 Vue3 中新增的一个生命周期函数，会在 beforeCreate 之前调用。因为此时组件的 data 和 methods 还没有初始化，因此在 setup 中是不能使用 this 的。所以 Vue 为了避免我们错误的使用，它直接将 setup 函数中的 this 修改成了undefined。并且，我们只能同步使用setup函数，不能用async将其设为异步。

setup 函数接收两个参数 props和 context， 语法为：setup(props,context){}

props

props 里面包含父组件传递给子组件的所有数据。在子组件中使用 props 进行接收。

props 是响应式的， 当传入新的 props 时，会及时被更新。
由于是响应式的， 所以不可以使用 ES6 解构，解构会消除它的响应式。

父组件：

<template>
    <!-- 父组件向子组件传递数据 -->
    <Sub :name="name" :age="age" />
</template>

<script>
import { ref } from 'vue'
import Sub from './Sub.vue'
export default {
    setup () {
        const name = ref('张三');
        const age = ref(20)

        return { name, age }
    },
    components: { Sub },
}
</script>

子组件（Sub.vue）:

<template>
    <div>{{name}}{{age}}</div>
</template>

<script>
export default {
    props: {
        name: String,
        age: Number
    },
    mounted () {
        // vue2.x 的写法
        console.log(this.name); // 张三
        console.log(this.age); // 20
    },
    setup (props) {
        // vue3.x 的写法
        console.log(props.name); // 张三
        console.log(props.age); // 20
        
        // let { name ,age } = props;  // 不能直接解构
        let { name, age } = toRefs(props);
        console.log(name.value, age.value); // 张三 20
    }
}
</script>

context

context 里面包含 attrs, slots, emit 等数据方法：

• attrs：获取组件上的属性
• slots：获取 slot 插槽的节点
• emit ：emit 方法（子组件向父组件传递数据）

父组件：

<template>
    <Sub subData="some other data" @subClick='subClick'>parent</Sub>
</template>

<script>
import Sub from './Sub.vue'
export default {
    setup () {

        function subClick (e) {
            console.log(e); // 接收子组件传递过来的数据
        }

        return { subClick }
    },
    components: { Sub },
}
</script>

子组件（Sub.vue）:

<template>
    <!-- 父组件向子组件传递数据 -->
    <div @click="handleClick">Child</div>
</template>

<script>
export default {
    mounted () {
        // vue2.x 获取组件上的属性
        console.log(this.$attrs.subData);  // 'some other data'
        
        // vue2.x 获取slot插槽的节点
        console.log(this.$slots);

    },
    methods: {
        // vue2.x emit方法(子组件向父组件传递数据)
        handleClick () {
            this.$emit('subClick', 'vue2.x - this is subData')
        },
    },
    setup (props, context) {
        let { attrs, slots, emit } = context;

        // vue3.x 获取组件上的属性
        console.log(attrs.subData);  // 'some other data'

        // vue3.x 获取slot插槽的节点
        console.log(slots.default());

        // vue3.x emit方法(子组件向父组件传递数据)
        function handleClick () {
            emit('subClick', 'vue3.x - this is subData');
        }

        return { handleClick }
    }
}
</script>

2. 生命周期

Vue3.x 生命周期

setup 函数是 Vue3 中新增的一个生命周期函数

• setup 函数会在 beforeCreate 之前调用，因为此时组件的 data 和 methods 还没有初始化，因此在 setup 中是不能使用 this 的。
• 所以 Vue 为了避免我们错误的使用，它直接将 setup 函数中的 this 修改成了undefined。
• setup函数，只能是同步的不能是异步的

初始化加载顺序：

setup => beforeCreate => created => onBeforeMount => onMounted

<script>
import { onBeforeMount, onMounted, onBeforeUpdate, onUpdated, onBeforeUnmount, onUnmounted, onRenderTracked, onRenderTriggered } from 'vue'
export default {
    setup () {
        console.log('setup');
        
        // 生命周期钩子(没有beforeCreate和created)
        onBeforeMount(() => { console.log('onBeforeMount'); })
        onMounted(() => { console.log('onMounted'); })
        onBeforeUpdate(() => { console.log('onBeforeUpdate'); })
        onUpdated(() => { console.log('onUpdated'); })
        onBeforeUnmount(() => { console.log('onBeforeUnmount'); })
        onUnmounted(() => { console.log('onUnmounted'); })

        // 新增的debug钩子  生产环境中会被忽略
        onRenderTracked(() => { console.log('onRenderTracked'); }) // 每次渲染后重新收集响应式依赖，在onMounted前触发，页面更新后也会触发
        onRenderTriggered(() => { console.log('onRenderTriggered'); }) // 每次触发页面重新渲染时的自动执行，在onBeforeUpdate之前触发
    },
    beforeCreate () {
        console.log('beforeCreate');
    },
    created () {
        console.log('created');
    }
}
</script>

3. 返回值

setup 函数中返回一个对象，可以在模板中直接访问该对象中的属性和方法。

<template>
    <div @click="handleClick">{{name1}} - {{name2}}</div>
</template>

<script>
import { ref, provide } from 'vue'
export default {
    setup () {
        const name1 = ref('张三');
        
        return {
            name1,
            name2: 'zhangsan',
            handleClick () {
                console.log(name1.value); // 张三
                console.log(this.name2); // zhangsan
            }
        }
    }
}
</script>

4. ref 与 reactive

创建一个响应式数据

• ref：任意类型（建议基本类型）数据的响应式引用（设置、获取值时需要加.value）。
  ref 的本质是拷贝，修改数据是不会影响到原始数据。
• reactive：只能是复杂类型数据的响应式引用

<template>
    <ul>
        <li>ref 基本类型：{{name1}}</li>
        <li>ref 复杂类型：{{name2.name}}</li>
        <li>reactive 复杂类型：{{name3.name}}</li>
    </ul>
</template>

<script>
import { ref, reactive } from 'vue'
export default {
    setup () {
        let nameStr = '张三';
        let name1 = ref(nameStr); // ref为基本数据类型添加响应式状态
        setTimeout(() => {
            name1.value = 'zhangsan';

            console.log(name1.value); // 'zhangsan'
            console.log(nameStr); // '张三'  =>  不会影响到原始数据
        }, 1000)


        let nameObj2 = { name: '张三' };
        let name2 = ref(nameObj2); // ref为复杂数据类型添加响应式状态（不建议）
        setTimeout(() => {
            // 设置值需要加.value
            name2.value.name = 'zhangsan';

            console.log(name2.value.name); // 'zhangsan'  =>  获取值需要加.value
            console.log(nameObj2); // {name: "zhangsan"}  =>  会影响到原始数据
        }, 2000)


        let nameObj3 = { name: '张三' };
        const name3 = reactive(nameObj3);// reactive只能为复杂数据类型添加响应式状态
        setTimeout(() => {
            name3.name = 'zhangsan';

            console.log(name3.name); // 'zhangsan'
            console.log(nameObj3); // {name: "zhangsan"}  =>  会影响到原始数据
        }, 3000)


        return { name1, name2, name3 }
    }
}
</script>

5. toRef 与 toRefs

也可以创建一个响应式数据

• toRef：用来给抽离响应式对象中的某一个属性，并把该属性包裹成 ref 对象，使其和原对象产生链接。
  toRef 的本质是引用，修改响应式数据会影响原始数据。
• toRefs：用来把响应式对象转换成普通对象，把对象中的每一个属性，包裹成 ref 对象。
  toRefs 就是 toRef 的升级版，只是toRefs 是把响应式对象进行转换，其余的特性和 toRef 无二

<template>
    <ul>
        <li>{{name1}}</li>
        <li>{{name2.name.value}}</li>
        <li>{{name}}</li>
    </ul>
</template>

<script>
import { toRef, toRefs, reactive } from 'vue'
export default {
    setup () {
        let nameObj1 = reactive({ name: '张三' });
        let name1 = toRef(nameObj1, 'name');
        let age1 = toRef(nameObj1, 'age '); // age不存在
        setTimeout(() => {
            name1.value = 'zhangsan';
            age1.value = 20; // 即便age不存在也能正常响应式赋值
        }, 1000)


        let nameObj2 = reactive({ name: '张三' });
        let age2 = toRef(nameObj3, 'age '); // age不存在
        let name2 = toRefs(nameObj2);
        setTimeout(() => {
            name2.name.value = 'zhangsan';
            age2.value = 20; // age不存在，赋值无反应
        }, 2000)


        let nameObj3 = reactive({ name: '张三' });
        setTimeout(() => {
            nameObj3.name = 'zhangsan';
        }, 3000)
        let { name } = toRefs(nameObj3); // 解构后仍需保持响应式

        return { name1, name2, name }
    }
}
</script>

6. readonly 只读属性

表示响应式对象不可修改

<template>
    <ul>
        <li>{{nameObj.name}}</li>
    </ul>
</template>

<script>
import { reactive, readonly } from 'vue'
export default {
    setup () {
        let nameObj = reactive({ name: '张三' });
        let readonlyObj = readonly(nameObj); // 对nameObj响应式对象设置成只读,不可修改

        setTimeout(() => {
            readonlyObj.name = 'zhangsan'; // 无法设置属性  =>  Set operation on key "name" failed: target is readonly. Proxy {name: "张三"}
        }, 1000)

        return { nameObj }
    }
}
</script>

7. computed 计算属性

<template>
    <div>
        <button @click="add">+</button>
        <p>{{addCount}}</p>
    </div>
</template>

<script>
import { ref, computed } from 'vue'
export default {
    setup () {
        const num = ref(0);
        const add = () => {
            num.value++
        }
        // 计算属性
        const addCount = computed(() => {
            return num.value * 2;
        })
        return { add, addCount }
    }
}
</script>

8. watch 与 watchEffect 监听属性

• watch 函数：
  用来侦听特定的数据源，并在回调函数中执行副作用。
  默认情况是惰性的，也就是说仅在侦听的源数据变更时才执行回调。
• watchEffect 函数：
  1.立即执行、立即监听（immediate）
  2.自动会感知代码依赖（自动收集依赖），不需要传递监听的内容（不需要像 watch 一样手动传入依赖）
  3.无法获得变化前的值（oldVal）

<template>
    <div>
        <p>{{name}}</p>
        <p>{{nameObj.name}}</p>
    </div>
</template>

<script>
import { ref, reactive, watch, watchEffect } from 'vue'
export default {
    setup () {

        // 监听基本类型
        const name = ref('张三');
        setTimeout(() => {
            name.value = '李四';
        }, 1000);
        
        watch(name, (newVal, oldVal) => {
            console.log(newVal, oldVal);
        }, { immediate: true }) // 立即执行



        // 监听复杂类型
        const nameObj = reactive({ name: 'zhangsan' })
        setTimeout(() => {
            nameObj.name = 'lisi';
        }, 2000);
        
        // 复杂数据无法直接监听、惰性
        watch(() => nameObj, (newVal, oldVal) => {
            console.log(newVal, oldVal); // 不会触发
        })
        
        // 需要深度监听、不惰性
        watch(() => nameObj, (newVal, oldVal) => {
            console.log(newVal, oldVal); // newVal、oldVal具有响应式
        }, { deep: true })
        
        // 也可以直接监听对象的属性
        watch(() => nameObj.name, (newVal, oldVal) => {
            console.log(newVal, oldVal);
        })



        // 同时监听多个对象
        watch([() => nameObj.name, () => nameObj.lastName], ([newName, newLastName], [oldName, oldLastName]) => {
            console.log(newName, oldName, newLastName, oldLastName);
        })



        const stop = watchEffect(() => {
            console.log(name);
            console.log(nameObj.name);
        })

        // 5秒后停止监听
        setTimeout(()=>{  
            stop();   
        },5000)
        
        
        return { name, nameObj }
    }
}
</script>

二、获取DOM节点

<template>
    <input type="text" value="张三" ref="hello">
</template>

<script>
import { ref, onMounted } from 'vue'
export default {
    setup () {
        const hello = ref(null); // 获取组件中ref="hello"的真实dom元素
        
        onMounted(() => {
            console.log(hello.value); // <input type="text">
            console.log(hello.value.value); // 张三
        })
        
        return { hello }
    }
}
</script>

三、provide 与 inject

父组件向子组件传递数据与方法

父组件：

<template>
    <Sub />
</template>

<script>
import { ref, provide } from 'vue'
import Sub from './Sub.vue'
export default {
    setup () {
        const name = ref('张三');

        // provide(别名, 要传递的数据和方法)
        provide('myName', name)
        provide('handleClick', () => {
            name.value = 'zhangsan';
        })

    },
    components: { Sub },
}
</script>

子组件(Sub.vue)：

<template>
    <div @click="handleClick">{{name}}</div>
</template>

<script>
import { inject } from 'vue'
export default {
    setup () {
        //调用 inject 方法，通过指定的别名，接收到父级共享的数据和方法
        const name = inject('myName');
        const handleClick = inject('handleClick');

        return { name, handleClick }
    }
}
</script>

四、Teleport 传送门

Teleport 翻译过来是传送的意思，就像是哆啦 A 梦中的 「任意门」 ，任意门的作用就是可以将人瞬间传送到另一个地方。

举例：
我们希望 Dialog 渲染的 dom 和顶层组件是兄弟节点关系, 在 App.vue 文件中定义一个供挂载的元素：

<template>
    <router-view />
    <div id="model"></div> <!-- 挂载点 -->
</template>

定义一个 Dialog 组件 Dialog.vue , 留意 to 属性， 与上面的 id选择器 一致：

<template>
    <teleport to="#model"> 
        <!-- 挂载内容 -->
        <div>title</div>
        <div>I'am a Dialog.</div>
    </teleport>
</template>

DOM 渲染效果如下：

image

我们使用 teleport 组件，通过 to 属性，指定该组件渲染的位置在 App.vue 中，但是 Dialog 又是完全由 Dialog.vue 组件控制。

五、Suspense

Suspense组件用于在等待某个异步组件解析时显示后备内容。

在 Vue2.x 中经常遇到这样的场景：

<template>
<div>
    <div v-if="!loading">
        <!-- 异步渲染 -->
        ...  
    </div>
    <div v-if="loading">
        加载中...
    </div>
</div>
</template>

在异步数据没加载前，一般我们都会提供一个加载中( loading )的动画，当数据返回时配合 v-if来控制数据显示。

现在 Vue3.x 新出的内置组件 Suspense , 它提供两个template slot, 刚开始会渲染一个 fallback 状态下的内容， 直到到达某个条件后才会渲染 default 状态的正式内容， 通过使用 Suspense 组件进行展示异步渲染就更加的简单。

<Suspense>
      <template #default>
            <!-- 异步渲染 -->
            ...  
      </template>
      <template #fallback>
          <div>
              Loading...
          </div>
      </template>
</Suspense>

Suspense 组件 只是一个带插槽的组件，只是它的插槽指定了 default 和 fallback 两种状态。

六、碎片化节点 Fragment

在 Vue2.x 中， template 中只允许有一个根节点：

<template>
    <div>
        <span></span>
        <span></span>
    </div>
</template>

但是在 Vue3.x 中，可以有多个根元素，也可以有把文本作为根元素

<template>
    <span></span>
    <span></span>
</template>

七、插槽与作用域插槽

Vue之slot插槽和作用域插槽

1. 插槽

父组件：

<template>
    <Child>
        <!-- Vue2.x写法
        <div slot="parent">
            <div>父组件</div>
        </div>
         -->
        <template v-slot:parent>
            <div>父组件</div>
        </template>
    </Child>
</template>

子组件（Child.vue）：

<template>
    <slot name='parent'>子组件</slot>
</template>

2. 作用域插槽

父组件：

<template>
    <Child>
        <!-- <template slot="content" slot-scope="scoped">  -->
        <template v-slot:content="scoped">
            <div>{{scoped.myName}}</div>
        </template>
    </Child>
</template>

子组件：

<template>
    <slot name="content" :myName="myName"></slot>
</template>

<script>

import { ref } from 'vue'
export default {
    setup () {

        let myName = ref("猫老板的豆")

        return { myName }
    },
}
</script>