Vue3.x 官网

Composition API 简介

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

在这里插入图片描述

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

在这里插入图片描述

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>

生命周期

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

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

Vue2.x	Vue3.x
beforeCreate	setup
created	setup
beforeMount	onBeforeMount
mounted	onMounted
beforeUpdate	onBeforeUpdate
updated	onUpdated
beforeDestroy	onBeforeUnmount
destroyed	onUnmounted
activated	onActivated
deactivated	onDeactivated
errorCaptured	onErrorCaptured
- -	onRenderTracked
- -	onRenderTriggered

初始化加载顺序：

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>

返回值

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>

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>

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>

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>

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>

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 渲染效果如下：

在这里插入图片描述

我们使用 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>

插槽与作用域插槽

插槽

父组件：

<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>

作用域插槽

父组件：

<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>

Vue3.x 新特性总结

Composition API 简介

setup 函数

props

context

生命周期

返回值

ref 与 reactive

toRef 与 toRefs

readonly 只读属性

computed 计算属性

watch 与 watchEffect 监听属性

获取DOM节点

provide 与 inject

Teleport 传送门

Suspense

碎片化节点 Fragment

插槽与作用域插槽

插槽

作用域插槽

推荐阅读