Vue3 快速上手

第一章：Vue3 简介

一、介绍

2020 年 9 月 18 日，Vue.js 发布 3.0 版本，代号：One Piece（海贼王）
耗时 2 年多、2600+次提交、30+个RFC、600+次PR、99位贡献者
github 上的 tags 地址：https://github.com/vuejs/vue-next/releases/tag/v3.0.0

二、Vue3 带来了什么

性能的提升

打包大小减少 41%
初次渲染快 55%, 更新渲染快 133%
内存减少 54%
......

源码的升级

使用 Proxy 代替 defineProperty 实现响应式
重写虚拟 DOM 的实现和 Tree-Shaking
......

拥抱 TypeScript

Vue3 可以更好的支持 TypeScript

新的特性

Composition API（组合 API）
- setup 配置
- ref 与 reactive
- watch 与 watchEffect
- provide 与 inject
  .....
新的内置组件
- Fragment
- Teleport
- Suspense
其他改变
- 新的生命周期钩子
- data 选项应始终被声明为一个函数
- 移除 keyCode 支持作为 v-on 的修饰符
  ......

三、创建 Vue3.0 工程

1. 使用 vue-cli 创建

官方文档：vue-create

bash

# 查看@vue/cli版本，确保@vue/cli版本在4.5.0以上
vue --version
# 安装或者升级你的@vue/cli
npm install -g @vue/cli
# 创建
vue create vue_test
# 启动
cd vue_test
npm run serve

2. 使用 vite 创建

vite 官网

1）什么是 vite？—— 新一代前端构建工具。

2）优势如下

开发环境中，无需打包操作，可快速的冷启动。
轻量快速的热重载（HMR）。
真正的按需编译，不再等待整个应用编译完成。

3）创建项目

bash

# 创建工程
npm create vue@latest # 或者 npm create vite@latest

# 进入工程目录
cd <project-name>
# 安装依赖
npm install
# 运行
npm run dev

第二章：Composition API

官方文档：https://cn.vuejs.org/api

https://cn.vuejs.org/guide/extras/composition-api-faq.html

一、是什么

使用传统 Options API 中，新增或者修改一个需求，就需要分别在 data、methods、computed 里查找并修改。

而 Composition API 让我们可以更加优雅的组织我们的代码、函数。让相关功能的代码更加有序的组织在一起。

二、常用 Composition API

1. 拉开序幕的 setup

1）理解：Vue3.0 中一个新的配置项，值为一个函数。

2）setup 是所有 Composition API（组合 API）“ 表演的舞台 ”。

3）组件中所用到的：数据、方法等等，均要配置在 setup 中。

4）setup 函数的两种返回值：

① 若返回一个对象，则对象中的属性、方法，在模板中均可以直接使用。（重点关注！）

② 若返回一个渲染函数：则可以自定义渲染内容。（了解）

5）使用细节：

① 尽量不要与 Vue2.x 配置混用

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

② setup 不能是一个 async 函数，因为返回值不再是 return 的对象，而是 promise，模板看不到 return 对象中的属性。（后期也可以返回一个 Promise 实例，但需要 Suspense 和异步组件的配合）

setup 的两个注意点

setup 执行的时机
- 在 beforeCreate 之前执行一次，this 是 undefined。
setup 的参数
- props：值为对象，包含组件外部传递过来，且组件内部声明接收了的属性。
- context：上下文对象
  - attrs：值为对象，包含组件外部传递过来，但没有在 props 配置中声明的属性，相当于 this.$attrs。
  - slots：收到的插槽内容，相当于 this.$slots。
  - emit：分发自定义事件的函数，相当于 this.$emit。
js
```
export default {
  props: {
    msg: String
  },
  setup(props, context) {
    // 在setup函数中，你可以访问props和context
    console.log(props.msg)
    console.log(context.attrs)
    console.log(context.slots)
    context.emit('myEvent')
  }
}
```
1
2
3
4
5
6
7
8
9
10
11
12

<script setup> 语法糖

script 标签添加 setup 标记之后：

① 不再需要写 export default {}。

② 不再需要 return。

③ 组件也无需注册直接使用。

vue

<script setup>
  const message = 'this is message'
  const logMessage = ()=>{
    console.log(message)
  }
</script>

2. 定义响应式数据

1）ref 函数

作用：定义一个响应式的数据。
语法：const xxx = ref(initValue)
- 创建一个包含响应式数据的引用对象（reference 对象，简称 ref 对象）。
- JS 中操作数据：xxx.value
- 模板中读取数据：不需要 .value，直接：<div>{{xxx}}</div>
  因为 vue3 会在解析模板的时候，发现是 RefImpl 的对象，会自动从 value 中读数据。
备注：
- 接收的数据可以是：基本类型、也可以是对象类型。
- 基本类型的数据：响应式依然是靠 Object.defineProperty() 的 get 与 set 完成的。
- 对象类型的数据：内部 “ 求助 ” 了 Vue3.0 中的一个新函数—— reactive 函数。

setup 中使用 ref
可以将这个引用绑定到模板中的元素或组件的 ref 属性上，然后在 setup 函数中访问这个元素或组件。
例如，创建一个引用并绑定到一个输入元素上：
js
import { ref, onMounted } from 'vue'

export default {
   setup() {
       const inputRef = ref(null)

       onMounted(() => {
          console.log(inputRef.value) // 打印出绑定的元素
       })

     return {
        inputRef
     }
 }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
然后在模板中这样使用这个引用：
html
<input ref="inputRef" />
1
inputRef 是一个响应式引用，它被绑定到一个输入元素上。当组件被挂载后，onMounted 钩子函数会被调用，可以在这个函数中访问 inputRef.value 来获取这个输入元素。
注意，需要在 setup 函数的返回值中包含 inputRef，这样它才能在模板中被访问。

2）reactive 函数

1）作用：定义一个对象类型的响应式数据（基本类型不要用它，要用 ref 函数）。

2）语法：const 代理对象 = reactive(源对象) 接收一个对象（或数组），返回一个代理对象（Proxy 的实例对象，简称 proxy 对象）

reactive 定义的响应式数据是“深层次的”。
内部基于 ES6 的 Proxy 实现，通过代理对象操作源对象内部数据进行操作。

reactive 对比 ref

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

3）toRef

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

语法：const name = toRef(person,'name')

应用：要将响应式对象中的某个属性单独提供给外部使用时。

扩展：toRefs 与 toRef 功能一致，但可以批量创建多个 ref 对象。

toRefs：这个函数用于创建多个 ref 对象，这些对象的值会跟踪响应式对象的所有属性。它接收一个响应式对象作为参数，并返回一个新的对象，这个对象的每个属性都是一个 ref，这些 ref 的值会跟踪响应式对象的相应属性。例如，const personRefs = toRefs(person)会返回一个新的对象，这个对象的每个属性都是一个 ref，这些 ref 的值会跟踪 person 对象的相应属性。

3. 计算属性与监视

1）computed 函数

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

javascript

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]
        }
    })
}

2）watch 函数

与 Vue2.x 中 watch 配置功能一致。

两个小“坑”：

监视 reactive 定义的响应式数据时：oldValue 无法正确获取、强制开启了深度监视（deep 配置失效）。
监视 reactive 定义的响应式数据中某个属性时：deep 配置有效。

javascript

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

// 情况二：监视多个ref定义的响应式数据
watch([sum,msg],(newValue,oldValue)=>{
	console.log('sum或msg变化了',newValue,oldValue)
}) 

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

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

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

// 特殊情况
// 无法正确获得oldValue！！
watch(()=>person.job,(newValue,oldValue)=>{
    console.log('person的job变化了',newValue,oldValue)
},{deep:true}) // 此处由于监视的是reactive定义的对象中的某个属性，所以deep配置有效

注意：watch 监视源只能是 getter/effect 函数、ref、reactive 对象或数组这些类型。

如果 watch 监视的是 ref(原始类型) ，不用写 value；而如果是 ref(对象) 需要 value 或者开启 deep 配置。

3）watchEffect 函数

watch 的套路是：既要指明监视的属性，也要指明监视的回调。

watchEffect 的套路是：不用指明监视哪个属性，监视的回调中用到哪个属性，那就监视哪个属性。

watchEffect 有点像 computed：

但 computed 注重的计算出来的值（回调函数的返回值），所以必须要写返回值。
而 watchEffect 更注重的是过程（回调函数的函数体），所以不用写返回值。

javascript

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

4. 生命周期

官方文档：https://cn.vuejs.org/api/options-lifecycle.html

https://cn.vuejs.org/guide/essentials/lifecycle.html

vue2.x 的生命周期 lifecycle_2

vue3.0 的生命周期 lifecycle_3

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

生命周期函数执行多次的时候，会按照顺序依次执行。

5. 自定义hook/组合式函数

官方文档：https://cn.vuejs.org/guide/reusability/composables.html

什么是 hook？本质是一个函数，把 setup 函数中使用的 Composition API 进行了封装。类似于 vue2.x 中的 mixin。

优势：复用代码，让 setup 中的逻辑更清楚易懂。

举例

如果我们要直接在组件中使用组合式 API 实现鼠标跟踪功能，它会是这样的：

vue

<template>
  Mouse position is at: {{ x }}, {{ y }}
</template>

<script setup>
  import { ref, onMounted, onUnmounted } from 'vue'

  const x = ref(0)
  const y = ref(0)

  function update(event) {
    x.value = event.pageX
    y.value = event.pageY
  }

  onMounted(() => window.addEventListener('mousemove', update))
  onUnmounted(() => window.removeEventListener('mousemove', update))
</script>

但是，如果我们想在多个组件中复用这个相同的逻辑呢？我们可以把这个逻辑以一个组合式函数的形式提取到外部文件中：

javascript

// 文件位置：./src/hook/useMouse.js
import { ref, onMounted, onUnmounted } from 'vue'

// 按照惯例，组合式函数名以“use”开头
export function useMouse() {
  // 被组合式函数封装和管理的状态
  const x = ref(0)
  const y = ref(0)

  // 组合式函数可以随时更改其状态。
  function update(event) {
    x.value = event.pageX
    y.value = event.pageY
  }

  // 一个组合式函数也可以挂靠在所属组件的生命周期上
  // 来启动和卸载副作用
  onMounted(() => window.addEventListener('mousemove', update))
  onUnmounted(() => window.removeEventListener('mousemove', update))

  // 通过返回值暴露所管理的状态
  return { x, y }
}

下面是它在组件中使用的方式：

vue

<template>
  Mouse position is at: {{ x }}, {{ y }}
</template>

<script setup>
 import { useMouse } from '../hook/useMouse'

 const { x, y } = useMouse()
</script>

一个组合式函数可以调用一个或多个其他的组合式函数。

举例来说，我们可以将添加和清除 DOM 事件监听器的逻辑也封装进一个组合式函数中：

javascript

// event.js
import { onMounted, onUnmounted } from 'vue'

export function useEventListener(target, event, callback) {
  // 如果你想的话，
  // 也可以用字符串形式的 CSS 选择器来寻找目标 DOM 元素
  onMounted(() => target.addEventListener(event, callback))
  onUnmounted(() => target.removeEventListener(event, callback))
}

有了它，之前的 useMouse() 组合式函数可以被简化为：

javascript

// mouse.js
import { ref } from 'vue'
import { useEventListener } from 'hook/event'

export function useMouse() {
  const x = ref(0)
  const y = ref(0)

  useEventListener(window, 'mousemove', (event) => {
    x.value = event.pageX
    y.value = event.pageY
  })

  return { x, y }
}

三、其它 Composition API

1. shallowReactive 与 shallowRef

shallowReactive：只处理对象最外层属性的响应式（浅响应式）。

shallowRef：只处理基本数据类型的响应式，不进行对象的响应式处理。

什么时候使用？

如果有一个对象数据，结构比较深，但变化时只是外层属性变化 ===> shallowReactive。
如果有一个对象数据，后续功能不会修改该对象中的属性，而是生新的对象来替换 ===> shallowRef。

2. readonly 与 shallowReadonly

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

3. toRaw 与 markRaw

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

4. customRef

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

实现防抖效果：

vue

<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. 依赖注入

官方文档：https://cn.vuejs.org/guide/components/provide-inject.html

https://cn.vuejs.org/api/composition-api-dependency-injection.html

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

具体写法：

祖组件中

javascript

setup(){
	// ......
    let car = reactive({name:'奔驰',price:'40万'})
    provide('car',car)
    // ......
}

后代组件中

javascript

setup(props,context){
	// ......
    const car = inject('car')
    return {car}
	// ......
}

6. 响应式数据的判断

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

第三章：新的组件

一、Fragment

在 Vue2 中：组件必须有一个根标签。

在 Vue3 中：组件可以没有根标签，内部会将多个标签包含在一个 Fragment 虚拟元素中。

好处：减少标签层级，减小内存占用。

二、Teleport

Teleport 是一种能够将我们的组件 html 结构移动到指定位置的技术。

vue

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

移动位置（to 属性）可以填写 html、body、CSS 选择器。

三、Suspense

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

2.使用步骤

1）异步引入组件

javascript

import {defineAsyncComponent} from 'vue' // 静态引入
const Child = defineAsyncComponent(()=>import('./components/Child.vue')) // 动态引入 / 异步引入

2）使用 Suspense 包裹组件，并配置好 default 与 fallback

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>

当 Child 组件正在加载时，用户会看到“加载中.....”。当 Child 组件加载完成并准备好被渲染时，<Suspense> 会自动切换到 default 插槽，显示 Child 组件。

第四章：其他

一、全局API的转移

Vue 2.x 有许多全局 API 和配置。

例如：注册全局组件、注册全局指令等。

javascript

// 注册全局组件
Vue.component('MyButton', {
  data: () => ({
    count: 0
  }),
  template: '<button @click="count++">Clicked {{ count }} times.</button>'
})

// 注册全局指令
Vue.directive('focus', {
  inserted: el => el.focus()
}

Vue3.0 中对这些 API 做出了调整

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

2.x 全局 API（`Vue`）	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	app.config.globalProperties

应用实例（app）什么鬼？

import { createAPP } from 'vue'
import APP from './App.vue'

createApp(App).mount('#app');

二、其他改变

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

过度类名的更改：

Vue2.x 写法

css

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

Vue3.x 写法

css

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

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

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

移除 v-on.native 修饰符

父组件中绑定事件

vue

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

子组件中声明自定义事件

vue

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

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

Vue3 快速上手 ​

第一章：Vue3 简介 ​

一、介绍 ​

二、Vue3 带来了什么 ​

性能的提升 ​

源码的升级 ​

拥抱 TypeScript ​

新的特性 ​

三、创建 Vue3.0 工程 ​

1. 使用 vue-cli 创建 ​

2. 使用 vite 创建 ​

第二章：Composition API ​

一、是什么 ​

二、常用 Composition API ​

1. 拉开序幕的 setup ​

2. 定义响应式数据 ​

1）ref 函数 ​

2）reactive 函数 ​

3）toRef ​

3. 计算属性与监视 ​

1）computed 函数 ​

2）watch 函数 ​

3）watchEffect 函数 ​

4. 生命周期 ​

5. 自定义hook/组合式函数 ​

三、其它 Composition API ​

1. shallowReactive 与 shallowRef ​

2. readonly 与 shallowReadonly ​

3. toRaw 与 markRaw ​

4. customRef ​

5. 依赖注入 ​

6. 响应式数据的判断 ​

第三章：新的组件 ​

一、Fragment ​

二、Teleport ​

三、Suspense ​

第四章：其他 ​

一、全局API的转移 ​

二、其他改变 ​

Vue3 快速上手

第一章：Vue3 简介

一、介绍

二、Vue3 带来了什么

性能的提升

源码的升级

拥抱 TypeScript

新的特性

三、创建 Vue3.0 工程

1. 使用 vue-cli 创建

2. 使用 vite 创建

第二章：Composition API

一、是什么

二、常用 Composition API

1. 拉开序幕的 setup

2. 定义响应式数据

1）ref 函数

2）reactive 函数

3）toRef

3. 计算属性与监视

1）computed 函数

2）watch 函数

3）watchEffect 函数

4. 生命周期

5. 自定义hook/组合式函数

三、其它 Composition API

1. shallowReactive 与 shallowRef

2. readonly 与 shallowReadonly

3. toRaw 与 markRaw

4. customRef

5. 依赖注入

6. 响应式数据的判断

第三章：新的组件

一、Fragment

二、Teleport

三、Suspense

第四章：其他

一、全局API的转移

二、其他改变