一、Options API(选项式API)的弊端

1.1 什么是选项式API

在Vue2.x中，编写组件的方式是使用Options API，它的特点是在对应的属性中编写对应的功能模块。

比如data中定义数据、methods中定义方法、computed中定义计算属性、watch中监听属性改变。

生命周期钩子也属于Options API（选项式API）。

1.2 选项式API的弊端

当我们实现某一个功能时，这个功能对应的代码逻辑会被拆分到各个属性中。

当组件变得很大、很复杂时，逻辑关注点的列表就会增长，那么同一个功能的逻辑就会被拆分的很分散。

特别是对于那些一开始没有编写这些组件的人（阅读组件的人）来说，这个组件的代码是难以阅读和理解的。

碎片化的代码使用理解和维护这个复杂的组件变得非常困难，很容易隐藏了潜在的逻辑问题。
当处理单个逻辑关注点时，需要不断的跳到相应的代码块中，增加了代码维护的成本。

二、Composition API(组合式API)概述

2.1 Composition API的作用

如果能将同一个逻辑关注点相关的代码收集在一起会更好一些，这就是Composition API想要做的事情。

Vue Composition API可以简称为VCA。

2.2 Composition API的编码位置

Vue3.x提供了setup函数来编写各种组合式API。

setup其实也是组件的另外一个选项，只不过这个选项可以用来替代大部分其他选项式API选项。

比如methods、computed、watch、data、各种生命周期钩子函数等等。

三、setup函数的参数和返回值

3.1 setup函数的参数

setup函数主要由两个参数：

props：父组件传递过来的属性会被放到props对象中
- props的类型，和选项式API中的的规则一样，在props选项中定义
- props的使用，在template中依然是可以把props中的属性当成普通Vue变量去使用。
- 在setup函数中用props，不可以通过this去获取
context：也称之为SetupContext，是setup函数的上下文对象，它主要由三个属性
- attrs：所有的非props的的属性
- slots：父组件传递过来的插槽，在以渲染函数返回时会有作用
- emit：当组件内部需要发出事件时会用到emit
- 主要是因为setup函数中不能访问this，所以无法通过this.$emit发出事件

3.2 setup函数的返回值

setup的返回值可以来替代data选项，因此setup的返回值可以在模板template中使用。

<script>
import { ref } from 'vue'
export default {
setup() {
// 定义counter的内容
// 默认定义的数据都不是响应式数据，使用ref可以让数据变成响应式的
let counter = ref(100)
return {counter}
}
}
</script>

setup的返回值可以来替代methods中定义的方法

<script>
import { ref } from 'vue'
export default {
setup() {
// 定义counter的内容
// 默认定义的数据都不是响应式数据，使用ref可以让数据变成响应式的
let counter = ref(100)
const increment = () => {
counter.value ++
console.log(counter.value)
}
return {counter, increment}
}
}
</script>

四、setup中如何定义响应式数据

4.1 reactive函数

代码示例：

<template>
<div>
<h2>账号: {{ account.username }}</h2>
<h2>密码: {{ account.password }}</h2>
<!-- 没使用reactive函数时，点击此按钮，能够修改数据，但是却不能渲染到页面上 -->
<button @click="changeAccount">修改账号</button>
</div>
</template>
<script>
// 1.引入reactive函数
import { reactive } from 'vue'
export default {
setup() {
// 2.使用reactive函数: 定义复杂类型的响应式数据数据
const account = reactive({
username: "张三",
password: "666666"
})
function changeAccount() {
account.username = "kobe"
}
// 3.返回定义的数据
return {account, changeAccount}
}
}
</script>

由代码示例可知，使用reactive函数注意好三步即可：

从Vue中引入reactive函数
把要定义的复杂数据类型（对象或者数组）传入reactive函数，reactive函数的返回值就是响应式数据不要
忘记在setup函数中返回才可以在模板上使用

为什么加了reactive函数后数据就变成了响应式的：

当我们使用reactive函数处理我们的数据之后，数据再次被使用时就会进行依赖收集。

当数据发生改变时，所有收集到的依赖都是进行对应的响应式操作。

选项式API中的data选项中的复杂数据，在底层也是交给了reactive函数将其编程响应式对象的。

4.2 ref函数

1）ref函数的基本使用

reactive函数对传入的类型是有限制的，它要求必须传入的是一个对象或者数组类型。

如果传入一个基本数据类型，比如String、Number、Boolean等等就会报出一个警告：

value cannot be made reactive : xxx

Vue3给我们提供了另外一个ref函数。

ref函数返回可变的响应式对象，该对象作为一个响应式的引用维护着它内部的值，这也是ref名称的来源。

它内部的值是在ref的value属性中被维护的，因此使用ref函数定义的变量，使用时需要从value属性取值。

代码示例：

<template>
<div>
<!-- 默认情况下在template中使用ref时, vue会自动对其进行解包(取出其中value) -->
<h2>当前计数: {{ counter }}</h2>
<button @click="increment">+1</button>
<button @click="counter++">+1</button>
</div>
</template>
<script>
// 1.引入ref函数
import { ref } from 'vue'
export default {
setup() {
// 2.ref函数: 主要定义简单类型的数据(也可以定义复杂类型的数据)
const counter = ref(0)
function increment() {
counter.value++
}
// 3.返回定义的数据
return {counter, increment}
}
}
</script>

2）ref浅层解包

<template>
<div>
<!--ref 浅层解包 （意思就是把ref变量放别的对象中时就会有下面两个情况）-->
<!-- 使用的时候不需要写.value -->
<h2>当前计数: {{ info.counter }}</h2>
<!-- 修改的时候需要写.value -->
<button @click="info.counter.value++">+1</button>
</div>
</template>
<script>
// 1.引入ref函数
import { ref } from 'vue'
export default {
setup() {
// 2.ref函数: 主要定义简单类型的数据(也可以定义复杂类型的数据)
const counter = ref(0)
const info = {counter}
// 3.返回定义的数据
return {counter}
}
}
</script>

注意点：

在模板中引入ref函数定义的值时，Vue会自动帮助我们进行解包操作
解包就是Vue自动取出ref函数所定义的变量中的value值
所以使用者并不需要在模板中通过ref.value 的方式来使用
在 setup函数内部，ref函数定义的值是一个ref引用，所以需要使用ref.value的方式去操作
关于ref的浅层解包
直接在template中使用ref变量，会进行自动解包
如果把ref变量放在一个对象当中会有下面的情况
- 使用时，会进行自动解包
- 修改时，不会进行自动解包，因此需要使用value属性去获取值

4.3 关于如何选择reactive函数和ref函数

1）选择reactive函数的场景

reactive函数应用于本地的数据的定义，本地数据代表这个数据并不是来源于服务器
reactive函数定义的复杂数据的多个属性之间是有一定联系的

import {reactive} from 'vue'
const user = reactive({
username: '张三',
password: '123456'
})

例如收集一个表单中的数据，就是很适合使用reactive函数的场景

2）选择ref函数的场景

定义本地的简单类型的数据

import {ref} from 'vue'
const message = ref('hello ref')

定义从服务器中获取的数据

import {ref} from 'vue'
const music = ref([])							// 定义一个本地数组
const serverMusicList = ['小星星', '虫儿飞']		// 模拟从服务器获取到的数据
music.value = serverMusicList					// 把数据赋值给music变量

这是经验之谈，很多优秀的开源项目中也都是这么取做的，文档中并没有明确说明什么情况使用什么

这其实也是程序员本身应该自己去考虑的问题

五、单向数据流和readonly的使用

5.1 单向数据流规范

1）什么是单向数据流规范

父组件传递给子组件的对象数据，子组件只能使用，不允许修改。

虽然是能修改的，但是违反了单向数据流的原则。

如果真的想修改这个数据，应该发出事件，让父组件监听这个事件，然后在父组件中进行修改。

2）为什么要遵循这个原则

今后项目中可能会有很多子组件，父组件的一个数据可能会传递给多个子组件。

由于传递的是数据对象的引用，因此其中一个子组件中修改了数据，会导致全部引用它的地方，全部受到影响。

而且维护时，难以知道是哪个位置修改的这个数据。

其它地方也有很多类似的概念规范：

react中
react有一个重要的原则：任何一个组件都应该像纯函数一样,不能修改传入的props
js中
在js中也有类似原则，熟悉js的可能会知道一个纯函数的概念。纯函数意思就是函数不要对传入的参数进行修改。

这些规范如果不遵守，代码确实也能实现功能。但是将来维护性将会非常差，谁试谁知道。

5.2 readonly的使用

在给组件传递数据时，如果希望组件使用传递的内容。但是不允许它们修改时，就可以使用readonly了。

因为单向数据流原则在Vue2.x的时候时没法从代码上避免的。如果一个程序员根本不知道这个原则。

就有可能写出难以维护的代码。

而Vue3.x则提供了readonly函数从编码层面去避免这个问题。

<template>
<!-- 给组件home传递一个只读数据 -->
<home :info="readonlyInfo" />
</template>
<script>
import { readonly } from 'vue'
setup() {
// 本地定义多个需要传递给子组件的数据
const info = reactive({
name: "张三",
age: 25,
height: 1.78
})
// 使用readOnly包裹info
const roInfo = readonly(info)
return {roInfo}
}
</script>

readonly返回的对象都是不允许修改的；但是经过readonly处理的原来的对象是允许被修改的。

比如对于语句const info = readonly(obj)，info对象是不允许被修改的。

当obj被修改时，readonly返回的info对象也会被修改；

但是我们不能去修改readonly返回的对象info；

如果代码本身就非常遵守单向数据流的原则，那么也可以不使用

readonly的其它注意点：

readonly会返回原始对象的只读代理
也就是它依然是一个Proxy，这是一个proxy的set方法被劫持，并且不能对其进行修改
在开发中常见的readonly方法会传入三个类型的参数：
类型一：普通对象
类型二：reactive返回的对象
类型三：ref的对象

六、Reactive相关的判断的API

isProxy：检查对象是否是由 reactive 或 readonly创建的 proxy
isReactive：检查对象是否是由reactive创建的响应式代理
如果该代理是 readonly 建的，但包裹了由 reactive 创建的另一个代理，它也会返回 true
isReadonly：检查对象是否是由 readonly 创建的只读代理。
toRaw ：返回reactive 或readonly 代理的原始对象（不建议保留对原始对象的持久引用。请谨慎使用）
shallowReactive：创建一个响应式代理，它跟踪其自身property的响应性

但不执行嵌套对象的深层响应式转换 (深层还是原生对象)。

shallowReadonly：创建一个proxy，使其自身的property为只读

但不执行嵌套对象的深度只读转换（深层还是可读、可写的）

这些用的可能不会很多，但是也要了解

七、ref其他的API

7.1 toRefs

使用ES6的解构语法，对reactive返回的对象进行解构获取值，数据将不再是响应式的。

const info = reactive({
name: "张三",
age: 25,
height: 1.78
})

ES6解构：

const {name, age, height} = info;

数据失去响应式

toRefs解构：

const {name, age, height} = toRefs(info);

解构后数据仍然保持响应式

7.2 unref

用于获取一个ref引用中的value。

如果参数是一个ref，则返回内部值，否则返回参数本身
这也是 val = isRef(val) ? val.value : val 的语法糖函数 7.3 isRef

判断值是否是一个ref对象。

7.4 shallowRef

创建一个浅层的ref对象。

7.5 triggerRef

手动触发和shallowRef创建对象的响应式。

到此这篇关于Vue组合式API--setup中定义响应式数据详解的文章就介绍到这了,更多相关Vue组合式APIsetup内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站！

标签 api, setup, Vue, 组合式

Vue组合式API--setup中定义响应式数据的示例详解

目录