快速掌握vue3

持续创作，加速成长！这是我参与「掘金日新计划 · 6 月更文挑战」的第1天，点击查看活动详情

vue3官网：v3.cn.vuejs.org

1、setup

setup是所有Composition API的容器，值为一个函数。组件中所用到的数据、方法等等，均要配置在setup中，它会在beforeCreate之前执行一次，注意：V3里this不再是指向Vue实例，访问this会是undefined

1.1、返回值

• 若返回一个对象，则对象中的属性、方法, 在模板中均可以直接使用。
• 若返回一个渲染函数：则可以自定义渲染内容。

1.2、语法

<script>
import { ref, reactive } from 'vue'

export default {
	name: 'Home',
	setup(props, context) {
		const title = ref('标题')
		const data = reactive({
			value: '哈哈哈'
		})
		return {
		  title,
		  data
		}
	}
}
</script>

1.3、setup的参数

• props：值为对象，包含组件外部传递过来，且组件内部声明接收了的属性
• context：上下文对象
  1. attrs: 值为对象，包含组件外部传递过来，但没有在props配置中声明的属性, 相当于this.$attrs
  2. slots: 收到的插槽内容, 相当于this.$slots
  3. emit: 分发自定义事件的函数, 相当于this.$emit

1.4、注意点

尽量不要与V2配置混用

V2配置（data、methos、computed…）中可以访问到setup中的属性、方法。 但在setup中不能访问到V2配置（data、methods、computed…）。 如果有重名, setup优先。

setup不能是一个async函数，因为返回值不再return的对象, 而是promise, 模板看不到return对象中的属性。

2、ref 创建响应式数据

使用ref可以创建一个包含响应式数据的引用对象（reference对象，简称ref对象），可以是基本类型、也可以是对象。

// 创建
const xxx = ref(value)
// 使用
xxx.value
// 在模板中
<div>{{xxx}}</div>

3、reactive 创建响应式数据

定义一个对象类型的响应式数据，内部基于ES6的Proxy实现，通过代理对象操作源对象内部数据进行操作

// 创建
const xxx = reactive({
    yyy: ''
})
// 使用
xxx.yyy

4、toRef 创建ref

创建一个ref对象，其value值指向另一个对象中的某个属性

const state = reactive({
  foo: 1,
  bar: 2
})

const fooRef = toRef(state, 'foo')

// 传递props
export default {
  setup(props) {
    useSomeFeature(toRef(props, 'foo'))
  }
}

5、toRefs 响应式转换

将响应式对象转换为普通对象，其中结果对象的每个property都是指向原始对象相应property的ref

const state = reactive({
  foo: 1,
  bar: 2
})
const stateAsRefs = toRefs(state)
// 此时state和stateAsRefs是关联的

6、shallowReactive 响应式外层转换

只处理对象最外层属性的响应式（浅响应式）。适用于：一个对象数据，结构比较深, 但变化时只是外层属性变化

const state = shallowReactive({
  foo: 1,
  nested: {
    bar: 2
  }
})

7、shallowRef 基本数据响应式

只处理基本数据类型的响应式, 不进行对象的响应式处理。适用于：一个对象数据，后续功能不会修改该对象中的属性，而是生新的对象来替换

const shallow = shallowRef({
  greet: 'Hello, world'
})

8、响应式变只读

8.1、readonly# 响应式变只读

让一个数据变为只读的（深只读），应用于不希望数据被修改时

const shallow = readonly({
  greet: 'Hello, world', // 只读
  nested: {
    bar: 2 // 只读
  }
})

8.2、shallowReadonly 响应式变只读

让一个响应式数据变为只读的（浅只读），应用于不希望数据被修改时

const shallow = shallowReadonly({
  foo: 1, // 只读
  nested: {
    bar: 2 // 非只读
  }
})

9、toRaw 响应式变非响应式

将一个由reactive生成的响应式对象转为普通对象，对这个普通对象的所有操作，不会引起页面更新。

const foo = {}
const Foo = reactive(foo)
console.log(toRaw(Foo) === foo) // true

10、markRaw 标记永远不响应式

标记一个对象，使其永远不会再成为响应式对象，有些值不应被设置为响应式的，例如复杂的第三方类库等，当渲染具有不可变数据源的大列表时，跳过响应式转换可以提高性能。

const foo = markRaw({})
console.log(isReactive(reactive(foo))) // false

// 嵌套在其他响应式对象中时也可以使用
const bar = reactive({ foo })
console.log(isReactive(bar.foo)) // false

11、customRef 依赖更新控制

创建一个自定义的 ref，并对其依赖项跟踪和更新触发进行显式控制。它需要一个工厂函数，该函数接收track和trigger函数作为参数，并且应该返回一个带有get和set的对象。

<script>
import { customRef } from 'vue'

export default {
	name: 'Home',
	setup() {
	    // 实现防抖函数
		const fn = function(value, delay = 500) {
			let timeout
			return customRef((track, trigger) => {
				return {
					get() {
						track()
						return value
					},
					set(newValue) {
						clearInterval(timeout)
						timeout = setTimeout(() => {
							console.log(newValue)
							value = newValue
							trigger()
						}, delay)
					}
				}
			})
		}
		const keyword = fn('', 500)
		return {
			keyword
		}
	}
}
</script>

12、响应式数据的判断

12.1、 isRef

检查一个值是否为一个ref对象

const val = ref('xxx')
isRef(val) // true

12.2、isReactive

检查一个值是否为一个isReactive对象

const val = isReactive({})
isRef(val) // true

12.3、isReadonly

检查一个对象是否是由readonly创建的只读代理

const state = reactive({
  name: 'John'
})
console.log(isReactive(state)) // true

12.4、isProxy

检查一个对象是否是由 reactive 或者 readonly 方法创建的 proxy

const state = reactive({
  name: 'John'
})
console.log(isProxy(state)) // true

13、Ref 获取DOM

由于V3中不在存在this，所以ref的获取调整了

13.1、单个ref

<div ref="Qrcode" class="qr_codeode_url" />

import { ref } from 'vue'

export default {
  setup() {
    const Qrcode = ref(null)
    // 挂载后
	onMounted(() => {
		console.log(Qrcode.value)
	})
    return {
      Qrcode
    }
  }
}

13.2、循环中的ref

V3中在for循环元素上绑定ref将不再自动创建$ref数组。要从单个绑定获取多个ref，请将ref绑定到一个更灵活的函数上

<div v-for="item in list" :ref="setItemRef"></div>

import { onBeforeUpdate, onUpdated } from 'vue'

export default {
  setup() {
    let itemRefs = []
    const setItemRef = el => {
      if (el) {
        itemRefs.push(el)
      }
    }
    onBeforeUpdate(() => {
      itemRefs = []
    })
    onUpdated(() => {
      console.log(itemRefs)
    })
    return {
      setItemRef
    }
  }
}

• itemRefs不必是数组：它也可以是一个对象，其ref可以通过迭代的key被设置
• 如有需要，itemRef也可以是响应式的，且可以被侦听

14、 computed 计算属性

与V2中computed配置功能一致 import { computed } from 'vue'

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
}

15、watch

1. 监视ref定义的响应式数据

watch(sum, (newValue, oldValue) => {
	console.log('sum变化了', newValue, oldValue)
}, {immediate:true})

2. 监视多个ref定义的响应式数据

watch([sum, msg], (newValue,oldValue) => {
	console.log('sum或msg变化了', newValue,oldValue)
}) 

3. 监视reactive定义的响应式数据

// 若watch监视的是reactive定义的响应式数据，则无法正确获得oldValue
// 若watch监视的是reactive定义的响应式数据，则强制开启了深度监视
watch(person, (newValue, oldValue) => {
	console.log('person变化了', newValue, oldValue)
}, { immediate:true, deep:false }) // 此处的deep配置不再奏效

4. 监视reactive定义的响应式数据中的某个属性

watch(() => person.job, (newValue, oldValue) => {
	console.log('person的job变化了', newValue, oldValue)
}, { immediate:true, deep:true }) 

5. 监视reactive定义的响应式数据中的某些属性

watch([() => person.job, () => person.name], (newValue, oldValue) => {
	console.log('person的job变化了', newValue, oldValue)
}, { immediate:true, deep:true })

6. 此处由于监视的是reactive素定义的对象中的某个属性，所以deep配置有效

watch(() => person.job, (newValue, oldValue) => {
    console.log('person的job变化了', newValue, oldValue)
}, { deep:true })

16、watchEffect

和watch的区别是，watch既要指明监视的属性，也要指明监视的回调。而watchEffect，不用指明监视哪个属性，监视的回调中用到哪个属性，那就监视哪个属性，不用写返回值。

// 回调中用到的数据只要发生变化，则直接重新执行回调
watchEffect(() => {
    const x1 = sum.value
    const x2 = person.age
    console.log('watchEffect配置的回调执行了')
})

17、生命周期

v3生命周期全都写在setup中

17.1、改变

• beforeDestroy 改名为 beforeUnmount
• destroyed 改名为 unmounted
• beforeCreate => setup
• created => setup
• beforeMount => onBeforeMount
• mounted => onMounted
• beforeUpdate => onBeforeUpdate
• updated => onUpdated
• beforeUnmount => onBeforeUnmount
• unmounted => onUnmounted

17.2、语法

setup() {
    onMounted(() => {
      console.log('mounted')
    })
}

17.3、hook 生命周期事件

通过事件来监听组件生命周期中的关键阶段

// V2的语法
<template>
  <child-component @hook:updated="onUpdated">
</template>

// V3的语法
<template>
  <child-component @vnode-updated="onUpdated">
</template>

// 驼峰写法
<template>
  <child-component @vnodeUpdated="onUpdated">
</template

18、API

18.1、应用api调整

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

V2的api	V3的api
Vue.config.xxxx	app.config.xxxx
Vue.component	app.component
Vue.directive	app.directive
Vue.mixin	app.mixin
Vue.use	app.use
Vue.prototype	app.config.globalProperties

18.2、移除api

名称	现状
Vue.config.productionTip	已移除
config.keyCodes	已移除
$children	已移除
$listeners	已移除
$on	已移除
$off	已移除
$once	已移除
filters	已移除
.native	已移除

19、nextTick 异步更新

import { nextTick } from 'vue'

nextTick(() => {
  // ...
})

20、provide & inject 通信

实现祖与后代组件间通信，父组件有一个provide选项来提供数据，后代组件有一个inject选项来开始使用这些数据

// 祖组件
setup(){
    let car = reactive({ name:'奔驰', price:'40万' })
    provide('car', car)
}
// 后代组件
setup(props, context){
    const car = inject('car')
    return { car }
}

21、emits 自定义事件

定义一个组件可以向其父组件触发的事件

// 在子组件中
<h1 @click="father">{{ msg }}</h1>

export default {
	name: 'HelloWorld',
	props: {
		msg: {
			type: String,
			default: ''
		}
	},
	emits: ['close'],
	setup(props, { emit }) {
		const father = function() {
			emit('close', 'child')
		}
		return {
			father
		}
	}
}

// 在父组件中
<HelloWorld :msg="msg" @click="fn" @close="fn2" />

22、teleport 移动dom组件

Teleport提供了一种干净的方法，允许我们控制在DOM中哪个父节点下渲染了HTML，而不必求助于全局状态或将其拆分为两个组件。

<teleport to="移动位置">
	<div v-if="isShow" class="mask">
		<div class="dialog">
			<h3>我是一个弹窗</h3>
			<button @click="isShow = false">关闭弹窗</button>
		</div>
	</div>
</teleport>


// to的格式
<teleport to="#some-id" />
<teleport to=".some-class" />
<teleport to="[data-teleport]" />

// disabled的格式
<teleport to="#popup" :disabled="displayVideoInline">
  <video src="./my-movie.mp4">
</teleport>

23、Suspense 异步渲染组件

等待异步组件时先渲染一些额外内容，让应用有更好的用户体验

<template>
	<div class="app">
		<h3>我是App组件</h3>
		<Suspense>
			<template #default>
				<Child/>
			</template>
			<template #fallback>
				<h3>加载中.....</h3>
			</template>
		</Suspense>
	</div>
</template>


import { defineAsyncComponent } from 'vue'
const Child = defineAsyncComponent(() => import('./components/Child.vue'))

components: {
    Child
}