Vue3 ：组合式写法入门

Vue3 ：组合式写法入门

Date: May 11, 2023
Sum: 使用create-vue搭建Vue3项目、组合式API - setup、reactive和ref、computed、watch、生命周期函数、父子通信、模版引用、provide/inject

---

认识Vue3

1. Vue3组合式API体验

通过 Counter 案例 体验Vue3新引入的组合式API

特点：

1. 代码量变少
2. 分散式维护变成集中式维护 2. Vue3更多的优势

---

---

2. Vue3更多的优势

---

---

---

使用create-vue搭建Vue3项目

1. 认识create-vue

create-vue是Vue官方新的脚手架工具，底层切换到了 vite （下一代前端工具链），为开发提供极速响应

---

---

2. 使用create-vue创建项目

前置条件 - 已安装16.0或更高版本的Node.js

执行如下命令，这一指令将会安装并执行 create-vue

npm init vue@latest

---

---

---

熟悉项目和关键文件

---

---

---

组合式API - setup选项

1. setup选项的写法和执行时机

写法：

---

关键：

1-执行时机：setup执行时机 > 在beforeCreate钩子之前执行

2-this：setup函数中，获取不到this ( this是undefined)

注意：因此，在以后的Vue组合式开发中不要使用this

理解：使用this会依赖于当前的环境，而使用Vue3不使用this，所以开发者就不必考虑this指向目标

---

案例：

效果：

代码：

理解：很明显setup的执行时机要比 beforeCreate 要早

---

---

2. setup中写代码的特点

在setup函数中写的数据和方法需要在末尾以对象的方式return，才能给模版使用

注意：这是原始写法，以后我们会采用下面的语法糖来解决问题。

---

---

3.

script标签添加 setup标记，不需要再写导出语句，默认会添加导出语句

原理：

左边是采用语法糖的写法，右边是转译后的复杂写法：

理解：实际运行的代码中还是有return的代码

案例：

总结：

1. setup选项的执行时机？
   1. beforecreate钩子之前 自动执行
2. setup写代码的特点是什么？
   1. 定义数据＋函数 然后以对象方式return

---

---

---

组合式API - reactive和ref函数

1. reactive

**作用：**接受对象类型数据的参数传入并返回一个响应式的对象

注：响应式对象可以引发视图的更新

核心步骤：

1. 从 vue 包中导入 reactive 函数

2. 在

案例：

效果：

---

---

2. ref

作用：接收简单类型或者对象类型的数据传入并返回一个响应式的对象

核心步骤：

1. 从 vue 包中导入 ref 函数

2. 在

本质：

是在原有传入数据的基础上，外层包了一层对象，包成了复杂类型。在包成复杂类型之后，再借助 reactice 实现的响应式。

注意点：

1-访问数据，需要通过 .value

2-在template中，.value 不需要加（帮我们扒了一层）

案例：

效果：

注意：打印通过ref创建的响应式对象

---

---

3. reactive 对比 ref

二者基本作用：接收数据，返回响应式对象

响应式对象：可以引发视图的更新

1. 都是用来生成响应式数据
2. 不同点
   1. reactive不能处理简单类型的数据
   2. ref参数类型支持更好，但是必须通过.value做访问修改
   3. ref函数内部的实现依赖于reactive函数
3. 在实际工作中的推荐
   1. 推荐使用ref函数，减少记忆负担

---

---

---

组合式API - computed

计算属性基本思想和Vue2保持一致，组合式API下的计算属性只是修改了API写法

核心步骤：

1. 导入computed函数
2. 执行函数在回调函数中return基于响 应式数据做计算的值，用变量接收

案例：

效果：

总结：

最佳实践

1. 计算属性中不应该有“副作用〞

   计算属性应该专注于数据的计算，而不应该处理如异步请求/修改dom等操作

2. 避免直接修改计算属性的值

   计算属性应该是只读的，因此我们的计算属性一般用const修饰

---

---

---

组合式API - watch

**作用：**侦听一个或者多个数据的变化，数据变化时执行回调函数，

两个额外参数 immediate控制立刻执行，deep开启深度侦听

1. 侦听单个数据

具体步骤：

1. 导入watph函数
2. 执行watch函数传入要侦听的响应式数据(ref对象)和回调函数

案例：

注意：watch中ref对象不需要加.value

效果：

---

---

2. 侦听多个数据

侦听多个数据，第一个参数可以改写成数组的写法

或者，后面参数你可以直接写成数组 (newArr, oldArr)：

watch([count, nickname], (newArr, oldArr) => {
  console.log(newArr, oldArr);
})

---

---

3. immediate

在侦听器创建时立即出发回调，响应式数据变化之后继续执行回调

案例：

注意：oldValue一开始是undefined

效果：

上来就会执行一次代码

---

---

4. deep

**默认机制：**通过watch监听的ref对象默认是浅层侦听的，直接修改嵌套的对象属性不会触发回调执行，需要开启deep

原理：watch监听的是对象的地址，如果你需要让watch监听对象的属性的值，那么需要开启deep

案例：

效果：

注意：开启deep也会开启递归遍历，会带来额外的性能损耗，所以绝大情况下，不建议开启deep

---

---

5. 精确侦听对象的某个属性

**需求：**在不开启deep的前提下，侦听age的变化，只有age变化时才执行回调

具体操作：

如果你想要侦听某个属性，那就在watch中将第一个参数写成回调函数的写法

案例：

效果：

总结：

1. 作为watch函数的第一个参数，ref对象需要添加.value吗？

不需要，watch会自动读取

2.watch只能侦听单个数据吗？

单个或者多个

1. 不开启deep，直接修改嵌套属性能触发回调吗？

   不能，默认是浅层侦听

2. 不开启deep，想在某个层次比较深的属性变化时执行回调怎么做？

   可以把第一个参数写成函数的写法，返回要监听的具体属性

---

---

---

组合式API - 生命周期函数

1. 选项式对比组合式

注意：Vue3中如果要销毁，是采用onUnmounted，而不是destoryed

理解：

在组合式API中没有beforeCreate/create这两构造函数, 可以将原本的内容填入setup中

---

---

2. 生命周期函数基本使用

具体操作：

1. 导入生命周期函数

2. 执行生命周期函数，传入回调

理解：Vue2中异步函数一般放在created中执行，因此在Vue3中我们直接放在setup中即可。

**效果：**直接挂载并输出内容

client.ts:18 [vite] connecting...
client.ts:150 [vite] connected.
App.vue:12 mounted生命周期函数
App.vue:6 发送请求，获取数据

---

---

3. 执行多次

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

案例：

import { onMounted } from 'vue'
onMounted(()=>{
  // 自定义逻辑
})

onMounted(()=>{
  // 自定义逻辑
})

效果：

如果遇到需要添加需求，我们又不想直接修改他人代码，

我们可以在下面在补充一个onMounted()，里面填写需要的补充逻辑。

总结：

1. 组合式API中生命周期函数的格式是什么？

   on＋生命周期名字

2. 组合式API中可以使用oncreated吗？

   没有这个钩子函数，直接写到setup中

3. 组合式AP1中组件卸载完毕时执行哪个函数？

   onUnmounted

---

---

---

组合式API - 父子通信

1. 父传子

基本思想：

1. 父组件中给子组件绑定属性

2. 子组件内部通过props选项接收数据

具体操作：

父组件：绑定属性

子组件：通过 defineProps （ 编译器宏函数） 接收子组件传递的数据

案例：

补充：这里添加了响应式数据的父传子的方式，即需要在组件中的属性前加上：

App.vue

son.vue

效果：

拓展理解：关于编译器宏函数

我们将代码放到Vue SFC Playground中，可以发现defineProps实际上是个标志，当代码编译时，会把左边的代码编译成右边我们熟悉的代码。

---

---

2. 子传父

基本思想:

1. 父组件中给子组件标签通过@绑定事件 2. 子组件内部通过 emit 方法触发事件

具体操作：

1. 父组件绑定自定义事件
2. 通过defineEmits编译器宏生成emit方法
3. 触发自定义事件，并传递参数

总结：

父传子

1. 父传子的过程中通过什么方式接收props?
   defineProps({属性名：类型}）

2. setup语法糖中如何使用父组件传过来的数据？
   const props =defineProps( {属性名：类型}）

   props.xxx

子传父

1．子传父的过程中通过什么方式得到emit方法？

defineEmits（['事件名称’]）

1. 怎么触发事件

   emit(’自定义事件名’，参数)

---

---

---

组合式API - 模版引用

概念：通过 ref标识 获取真实的 dom对象或者组件实例对象

1. 基本使用

实现步骤： 1. 调用ref函数生成一个ref对象 2. 通过ref标识绑定ref对象到标签

代码演示：

理解：通过1和2两步，dom对象已经被存到了h1Ref.value身上

关键：

如果你想要拿到 ref对象身上的值，你必须要等到DOM渲染完，也就是你得等onMounted钩子完成后

**案例：**一进页面就聚焦

理解：这里是通过ref来操作DOM对象

效果：

---

---

2. defineExpose

默认情况下在

说明：指定testMessage属性可以被访问到

案例：

效果：

App.vue

test-com.vue

总结：

1. 获取模板引用的时机是什么？ 组件挂载完毕
2. defineExpose编译宏的作用是什么？ 显式暴露组件内部的属性和方法

---

---

---

组合式API - provide和inject

1. 作用和场景

顶层组件向任意的底层组件传递数据和方法，实现跨层组件通信

理解：room-page称为顶层组件，room-msg-comment称为底层组件

---

---

2. 跨层传递普通数据

实现步骤：

1. 顶层组件通过 provide 函数提供数据
2. 底层组件通过 inject 函数提供数据

顶层组件：

provide('key', 顶层组件中的数据)

底层组件：

const message = inject('key')

注意：以上二者的key相互关联

案例：

效果：

---

---

3. 跨层传递响应式数据

具体操作：在调用provide函数时，第二个参数设置为ref对象
顶层组件：

provide('app-key', ref对象)

底层组件：

const message = inject('app-key')

案例：

效果：

---

---

4. 跨层传递方法

逻辑：顶层组件可以向底层组件传递方法，底层组件调用方法修改顶层组件的数据

顶层组件：

const setCount = () => {
	count.value++
}
provide('setCount-key', setCount)

底层组件：

const setCount = inject('setCount-key')

案例：

效果：点击按钮，顶层组件的响应式数据会变化

总结：

需求1: 我们需要从顶层传递订单id等信息到底层组件

顶层提供provide(’id-key’, orderId)，底层采用 inject(’id-key’) 接收，从而实现顶层数据向底层的传递。

需求2: 底层通知顶层评价完毕

顶层提供provide(’state-fn’, changeState)传递函数, 底层通过inject(’state-fn’) → changeState()接收函数并调用，从而实现对顶层数据的修改

Q&A:

1. provide和inject的作用是什么？
   跨层组件通信
2. 如何在传递的过程中保持数据响应式？
   第二个参数传递ref对象
3. 底层组件想要通知顶层组件做修改，如何做？
   传递方法，底层组件调用方法
4. 一颗组件树中只有一个顶层或底层组件吗？
   相对概念，存在多个顶层和底层的关系

---

---

---

Vue3.3 新特性

defineOptions

背景说明：

有

但是用了

---

为了解决这一问题，引入了 defineProps 与 defineEmits 这两个宏。但这只解决了 props 与 emits 这两个属性。

如果我们要定义组件的 name 或其他自定义的属性，还是得回到最原始的用法——再添加一个普通的

这样就会存在两个

---

所以在 Vue 3.3 中新引入了 defineOptions 宏。顾名思义，主要是用来定义 Options API 的选项。可以用 defineOptions 定义任意的选项， props, emits, expose, slots 除外（因为这些可以使用 defineXXX 来做到）

理解：由于我们引入了setup语法糖的用法，导致了无法给setup提供一些平级的属性。因此，官方提供了defineOption宏，用于定义Options API选项。

---

---

defineModel

注：这是一个试验性质的用法

在Vue3中，自定义组件上使用v-model, 相当于传递一个modelValue属性，同时触发 update:modelValue 事件

我们需要先定义 props，再定义 emits 。其中有许多重复的代码。如果需要修改此值，还需要手动调用 emit 函数。

于是乎 defineModel 诞生了。

生效需要配置 vite.config.js

import { fileURLToPath, URL } from 'node:url'

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

// https://vitejs.dev/config/
export default defineConfig({
  plugins: [
    vue({
      script: {
        defineModel: true
      }
    }),
  ],
  resolve: {
    alias: {
      '@': fileURLToPath(new URL('./src', import.meta.url))
    }
  }
})

---

---

---

综合案例

案例演示：

1. 项目地址

git clone  http://git.itcast.cn/heimaqianduan/vue3-basic-project.git

2. 项目说明

1. 模版已经配置好了案例必须的安装包
2. 案例用到的接口在 README.MD文件 中
3. 案例项目有俩个分支，main主分支为开发分支，complete分支为完成版分支供开发完参考

3. 项目实现：

步骤1: 列表渲染

效果：

实现：

// TODO1: 列表渲染
// 思路：声明响应式list -> 调用接口获取数据 -> 后端数据赋值给list -> 绑定到table组件

// 具体步骤：
const list = ref([])
// 1.调用发送的异步请求
const getList = async () => {
  // 接口调用
  const res = await axios.get('/list')
  // 交给list
  list.value = res.data
}
onMounted( () => getList())

说明：我们将数据传输给相应的列表

步骤2: 删除功能

效果：

实现：

// TODO: 删除功能
// 思路：获取当前行的id -> 通过id调用删除接口 -> 更新最新的列表
const onDelete = async (id) => {
  console.log(id);
  await axios.delete(`/del/${id}`)
  getList()
}

说明：

步骤3: 编辑功能

效果：

实现：

主组件：

// TODO: 编辑功能
// 思路：打开弹窗 -> 回填数据 -> 更新数据
// 1. 打开弹窗 （获取子组件实例 调用方法或者修改属性）
const editRef = ref(null)
const onEdit = (row) => {
  editRef.value.open(row)
}
// 2. 回调数据 （调用详情接口 / 当前行的静态数据）

编辑功能组件：