主要讲了
响应式数据是MVVM数据变驱动编程的特色, VUE的设计也是受 MVVM模型的启发,大部分开发者选择MVVM框架都是因为数据驱动编程比传统的事件驱动编程来的方便。而选择vue,则是方便中的方便。
⭐️ Model-View-ViewModel 简称MVVM 是一种软件架构模式,将视图UI 和 业务逻辑分开,通过逻辑数据的修改驱动视图UI的更新,因此称为 “数据驱动”,与之对应是操作DOM完成视图更新的编程方式“事件驱动”。
作为最重要的一个亮点,Vue3 的响应式数据在设计上和Vue2 有很大的不同。
vue2 是使用了 Object.defineProperty
API 的getter / setter 来实现数据的响应式,这个方法的具体用法可以参考
MDN 的文档: Object.defineProperty - MDN 。
下面使用 Object.defineProperty
实现一个简单的双向绑定 demo ,亲自敲代码试一下可以有更多的理解:
DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>DefineProperty Demotitle>
head>
<body>
<div>
<input type="text" id="input" />
<button onclick="vm.text = 'Hello World'"> 设置为 hello world button>
div>
<div id="output">div>
<script>
// 声明一个响应式数据
let vm = {};
Object.defineProperty(vm, 'text', {
set(value) {
console.log("set事件触发了");
document.querySelector("#input").value = value;
document.querySelector("#output").innerText = value;
}
})
document.querySelector("#input").oninput = function(e){
vm.text = e.target.value;
}
script>
body>
html>
这个小 demo 实现了这两个功能:
vm.text
的数据,但会同时更新 output 标签的文本内容vm.text
的数据,也会触发输入框和 output 文本的更新当然 Vue 做了非常多的工作,而非只是简单的调用了 Object.defineProperty
,可以在官网 深入 Vue 2 的响应式原理 一章了解更多 Vue 2 的响应式原理。
vue3 是使用了 Proxy API 的getter/setter 来实现数据的响应式,这个方法的具体用法参考 MDN 的文档: Proxy - MDN 。
同样的,也来实现一个简单的双向绑定 demo ,这次使用 Proxy
来实现:
DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Proxy Demotitle>
head>
<body>
<div>
<input type="text" id="input" />
<button onclick="vm.text = 'Hello World'">设置为 Hello Worldbutton>
div>
<div id="output">div>
<script>
// 声明一个响应式数据
const vm = new Proxy(
{},
{
set(obj,key,value){
console.log("set事件触发了");
document.querySelector("#input").value = value;
document.querySelector("#output").innerText = value;
}
}
)
document.querySelector("#input").oninput = function(e){
vm.text = e.target.value;
}
script>
body>
html>
这个 demo 实现的功能和使用 Object.defineProperty
的 demo 是完全一样的,也都是基于 setter
的行为完成数据更新的实现,那么为什么 Vue 3 要舍弃 Object.defineProperty
,换成 Proxy
呢?
主要原因在于 Object.defineProperty 有以下不足:
1, 无法侦听数组下标的变化, 通过 arr[i] = newValue
修改值,无法实时响应。
2,无法侦听数据长度的变化,例如通过 arr.length = 10 修改数组长度,无法实时响应。
3,只能侦听对象的属性,对于整个对象需要遍历,特别是多级对象更是要通过嵌套来深度侦听。
4,使用 Object.assign() 等方法给对象添加新属性时,也不会触发更新。
这也是为什么 Vue 2 要提供一个 Vue.set API 的原因,可以在官网 Vue 2 中检测变化的注意事项 一章了解更多说明。
而这些问题在 Proxy
都可以得到解决,可以在官网 深入 Vue 3 的响应式原理 一章了解更多这部分的内容。
本篇只使用 Composition API
编写组件,这是使用 Vue 3 的最大优势。
⭐️ 虽然官方文档在各个 API 的使用上都做了一定的举例,但在实际使用过程中可能会遇到一些问题,常见的情况就是有些数据用着用着就失去了响应,或者是在 TypeScript 里出现类型不匹配的报错等等。
当然,一般遇到这种情况并不一定是框架的 BUG ,而可能是使用方式不对,本章节将结合笔者最初入门 Vue 3 时遇到的问题和解决问题的心得,复盘这些响应式 API 的使用。
相对与 vue2 在 data 里面声明候,即可通过 thisl.xxx
调用响应式数据,在 vue3 的生命周期里没有了 vue 实例的 this 指向, 需要导入 ref 、reactive
等响应式API 才能声明并使用响应式数据。
// 这里导入的 `ref` 是一个响应式 API
import { defineComponent, ref } from 'vue'
export default defineComponent({
setup() {
// 通过响应式 API 创建的变量具备了响应性
const msg = ref<string>('Hello World!')
},
})
由于VUE3 新的API 很多,这里只展示常用的API,更多的请查看官方文档 响应性 API 一章查阅。
ref 是最常用的一个响应式API, 它可以用来定义所有的类型的数据,包括Node 节点和组件。
没错,在 Vue 2 常用的 this.$refs.xxx
来取代 document.querySelector('.xxx')
获取 Node 节点的方式,也是使用这个 API 来取代。
在开始使用 API 之前,需要先了解在 TypeScript 中如何声明 Ref 变量的类型。
先看 API 本身, ref
API 是一个函数,通过接受一个泛型入参,返回一个响应式对象,所有的值都通过 .value
属性获取,这是 API 本身的 TS 类型:
// `ref` API 的 TS 类型
function ref<T>(value: T): Ref<UnwrapRef<T>>
// `ref` API 的返回值的 TS 类型
interface Ref<T> {
value: T
}
因此在声明变量时,是使用尖括号 <>
包裹其 TS 类型,紧跟在 ref
API 之后:
// 显式指定 `msg.value` 是 `string` 类型
const msg = ref<string>('Hello World!')
再回看该 API 本身的类型,其中使用了 T
泛型,这表示在传入函数的入参时,可以不需要手动指定其 TS 类型, TypeScript 会根据这个 API 所返回的响应式对象的 .value
属性的类型,确定当前变量的类型。
因此也可以省略显式的类型指定,像下面这样声明变量,其类型交给 TypeScript 去自动推导:
// TypeScript 会推导 `msg.value` 是 `string` 类型
const msg = ref('Hello World')
对于声明时会赋予初始值,并且在使用过程中不会改变其类型的变量,是可以省略类型的显式指定的。
而如果有显式的指定的类型,那么在一些特殊情况下,初始化时可以不必赋值,这样 TypeScript 会自动添加 undefined
类型:
const msg = ref<string>()
console.log(msg.value) // undefined
msg.value = 'Hello World!'
console.log(msg.value) // Hello World!
因为入参留空时,虽然指定了 string
类型,但实际上此时的值是 undefined
,因此实际上这个时候的 msg.value
是一个 string | undefined
的联合类型。
对于声明时不知道是什么值,在某种条件下才进行初始化的情况,就可以省略其初始值,但是切记在调用该变量的时候对 .value
值进行有效性判断。
而如果既不显式指定类型,也不赋予初始值,那么会被默认为 any
类型,除非真的无法确认类型,否则不建议这么做。
细心的开发者还会留意到 ref
API 类型里面还标注了一个返回值的 TS 类型:
interface Ref<T> {
value: T
}
它是代表整个 Ref 变量的完整类型:
string
类型都是指 msg.value
这个 .value
属性的类型msg
这个响应式变量,其本身是 Ref
类型如果在开发过程中需要在函数里返回一个 Ref 变量,那么其 TypeScript 类型就可以这样写(请留意 Calculator
里的 num
变量的类型):
// 导入 `ref` API
import { ref } from 'vue'
// 导入 `ref` API 的返回值类型
import type { Ref } from 'vue'
// 声明 `useCalculator` 函数的返回值类型
interface Calculator {
// 这里包含了一个 Ref 变量
num: Ref<number>
add: () => void
}
// 声明一个 “使用计算器” 的函数
function useCalculator(): Calculator {
const num = ref<number>(0)
function add() {
num.value++
}
return {
num,
add,
}
}
// 在执行使用计算器函数时,可以获取到一个 Ref 变量和其他方法
const { num, add } = useCalculator()
add()
console.log(num.value) // 1
上面这个简单的例子演示了如何手动指定 Ref 变量的类型,对于逻辑复用时的函数代码抽离、插件开发等场景非常有用!当然大部分情况下可以交给 TypeScript 自动推导,但掌握其用法,在必要的时候就派得上用场了!
在了解了如何对 Ref 变量进行类型声明之后,面对不同的数据类型,相信都得心应手了!但不同类型的值之间还是有少许差异和注意事项,例如上文提及到该 API 可以用来定义所有类型的数据,包括 Node 节点和组件,具体可以参考下文的示例。
对字符串、布尔值等基本类型的定义方式,比较简单:
// 字符串
const msg = ref<string>('Hello World!')
// 数值
const count = ref<number>(1)
// 布尔值
const isVip = ref<boolean>(false)
对于对象、数组等引用类型也适用,比如要定义一个对象:
// 先声明对象的格式
interface Member {
id: number
name: string
}
// 在定义对象时指定该类型
const userInfo = ref<Member>({
id: 1,
name: 'Tom',
})
定义一个普通数组:
// 数值数组
const uids = ref<number[]>([1, 2, 3])
// 字符串数组
const names = ref<string[]>(['Tom', 'Petter', 'Andy'])
定义一个对象数组:
// 声明对象的格式
interface Member {
id: number
name: string
}
// 定义一个对象数组
const memberList = ref<Member[]>([
{
id: 1,
name: 'Tom',
},
{
id: 2,
name: 'Petter',
},
])
除了可以定义数据,ref
也有熟悉的用途,就是用来挂载节点,也可以挂在子组件上,也就是对应在 Vue 2 时常用的 this.$refs.xxx
获取 DOM 元素信息的作用。
模板部分依然是熟悉的用法,在要引用的 DOM 上添加一个 ref
属性:
请留意该节点,有一个 ref 属性
在 部分有三个最基本的注意事项:
代码里添加的 ref
属性的值,是对应
里使用 ref
API 声明的变量的名称;onMounted
或者 nextTick
函数里,这一点在 Vue 2 也是一样);return
出去才可以给到
使用,这一点是 Vue 3 生命周期的硬性要求,子组件的数据和方法如果要给父组件操作,也要 return
出来才可以。配合上面的 ,来看看
部分的具体例子:
import { defineComponent, onMounted, ref } from 'vue'
import Child from '@cp/Child.vue'
export default defineComponent({
components: {
Child,
},
setup() {
// 定义挂载节点,声明的类型详见下方附表
const msg = ref<HTMLElement>()
const child = ref<InstanceType<typeof Child>>()
// 请保证视图渲染完毕后再执行节点操作 e.g. `onMounted` / `nextTick`
onMounted(() => {
// 比如获取 DOM 的文本
console.log(msg.value.innerText)
// 或者操作子组件里的数据
child.value.isShowDialog = true
})
// 必须 `return` 出去才可以给到 `` 使用
return {
msg,
child,
}
},
})
关于 DOM 和子组件的 TS 类型声明,可参考以下规则:
节点类型 | 声明类型 | 参考文档 |
---|---|---|
DOM 元素 | 使用 HTML 元素接口 | HTML 元素接口 |
子组件 | 使用 InstanceType 配合 typeof 获取子组件的类型 | typeof 操作符 |
TIP
单纯使用 typeof Child
虽然可以获得 Child.vue 组件的 Props 和方法等提示,但在 VSCode 的类型推导还不够智能,缺乏更有效的代码补全支持。
上文使用的 InstanceType
是 TypeScript 提供的一个工具类型,可以获取构造函数类型的实例类型,因此将组件的类型声明为 InstanceType
,不仅可以得到更完善的类型提示,在编程过程中还可以让编辑器提供更完善的代码补全功能。
另外,关于这一小节,有一个可能会引起 TS 编译报错的情况是,一些脚手架创建出来的项目会默认启用 --strictNullChecks
选项,会导致案例中的代码无法正常编译,出现如下报错:
❯ npm run build
> hello-vue3@0.0.0 build
> vue-tsc --noEmit && vite build
src/views/home.vue:27:7 - error TS2532: Object is possibly 'undefined'.
27 child.value.isShowDialog = true
~~~~~~~~~~~
Found 1 error in src/views/home.vue:27
这是因为在默认情况下 null
和 undefined
是所有类型的子类型,但开启了 strictNullChecks
选项之后,会使 null
和 undefined
只能赋值给 void
和它们各自,这是一个更为严谨的选项,可以保障程序代码的健壮性,但对于刚接触 TypeScript 不久的开发者可能不太友好。
有以下几种解决方案可以参考:
// 添加 `if` 分支,判断 `.value` 存在时才执行相关代码
if (child.value) {
// 读取子组件的数据
console.log(child.value.num)
// 执行子组件的方法
child.value.sayHi('Use `if` in `onMounted` API.')
}
?
将目标设置为可选,避免出现错误(这个方式不能直接修改子组件数据的值):// 读取子组件的数据(留意 `.num` 前面有一个 `?` 问号)
console.log(child.value?.num)
// 执行子组件的方法(留意 `.sayHi` 前面有一个 `?` 问号)
child.value?.sayHi('use ? in onMounted')
tsconfig.json
文件里,显式的关闭 strictNullChecks
选项,关闭后,需要开发者在写代码的时候,自行把控好是否需要对 null
和 undefined
进行判断:{
"compilerOptions": {
// ...
"strictNullChecks": false
}
// ...
}
前面在介绍 API 类型的时候已经了解,通过 ref
声明的变量会全部变成对象,不管定义的是什么类型的值,都会转化为一个 Ref 对象,其中 Ref 对象具有指向内部值的单个 Property .value
。
也就是说,任何 Ref 对象的值都必须通过 xxx.value
才可以正确获取。
请牢记上面这句话,初拥 Vue 3 的开发者很多 BUG 都是由于这个问题引起的(包括笔者刚开始使用 Vue 3 的那段时间,嘿嘿)。
平时对于普通变量的值,读取的时候都是直接调用其变量名即可:
// 读取一个字符串
const msg: string = 'Hello World!'
console.log(msg)
// 读取一个数组
const uids: number[] = [1, 2, 3]
console.log(uids[1])
而 Ref 对象的值的读取,切记!必须通过 .value
!
// 读取一个字符串
const msg = ref<string>('Hello World!')
console.log(msg.value)
// 读取一个数组
const uids = ref<number[]>([1, 2, 3])
console.log(uids.value[1])
普通变量需要使用 let
声明才可以修改其值,由于 Ref 对象是个引用类型,所以可以使用 const
声明,直接通过 .value
修改。
// 声明一个字符串变量
const msg = ref<string>('Hi!')
// 等待 1s 后修改它的值
setTimeout(() => {
msg.value = 'Hello!'
}, 1000)
因此日常业务中,像在对接服务端 API 的接口数据时,可以自由的使用 forEach
、map
、filter
等方法操作 Ref 数组,或者直接重置它,而不必担心数据失去响应性。
const data = ref<string[]>([])
// 提取接口的数据
data.value = api.data.map((item: any) => item.text)
// 重置数组
data.value = []
为什么突然要说这个呢?因为涉及到下一部分的知识,关于 reactive
API 在使用上的注意事项。
reactive 是继 ref 之后最常用的一个响应式 API 了,相当于 ref , 它的局限性在于只适合 对象和数组
。
使用reactive 的好处就是写法跟平时的对象、数组几乎一模一样,但也有特殊的地方。
reactive
变量的声明方式没有 ref
的变化那么大,基本上和普通变量一样,它的 TS 类型如下:
function reactive<T extends object>(target: T): UnwrapNestedRefs<T>
可以看到其用法还是比较简单的,
// 声明对象的类型
interface Member {
id: number
name: string
}
// 定义一个对象
const userInfo: Member = reactive({
id: 1,
name: 'Tom',
})
const nameList : number[] = reactive([ 1 , 2 , 3 ])
// 对象数组也是先声明其中的对象类型
interface Member {
id: number
name: string
}
// 再定义一个为对象数组
const userList: Member[] = reactive([
{
id: 1,
name: '法外狂徒',
},
{
id: 2,
name: '张三丰',
},
{
id: 3,
name: 'come on 北鼻',
},
])
虽然 reactive
API 在使用上没有像 ref
API 一样有 .value
的负担,但也有一些注意事项要留意。
Reactive 对象在读取字段的值,或者修改值的时候,与普通对象是一样的,这部分没有太多问题。
// 声明对象的接口;
interface Member {
id: number
name: string
}
// 定义一个对象
const userInfo : Member = reactive({
id: 1,
name: "段誉"
})
console.log(userInfo.name)
userInfo.name = "乔峰"
Reactive数组,和普通数组会有一些区别,
普通数组 重置和修改操作:
// 定义一个普通数组
let uids : number[] = [1,2,3]
// 从另外一个对象数组里提取数据过来
uids = api.data.map((item :any) => item.id)
// 合并另外一个数组
let newUids: number[] = [4, 5, 6]
uids = [...uids, ...newUids]
// 重置数组
uids = []
Vue 2 在操作数组的时候,也可以和普通数组这样处理数据的变化,依然能够保持响应性,但在 Vue 3 ,如果使用 reactive
定义数组,则不能这么处理,必须只使用那些不会改变引用地址的操作。
笔者刚开始接触时,按照原来的思维去处理 reactive
数组,于是遇到了 “数据变了,但模板不会更新的问题” ,如果开发者在学习的过程中也遇到了类似的情况,可以从这里去入手排查问题所在。
举个例子,比如要重置数组,如果使用常规的重置,会导致这个变量失去响应性:
reactive 响应式数据测试
{{ nu }}
案例演示
reactive 让数据保持响应式的操作方式是:通过重置数组的 length 长度来实现数据的重置:
reactive 响应式数据测试
{{ nu }}
案例演示
❤️ ❤️ ❤️ 不要对 Reactive 数据进行 ES6 的解构 操作,因为解构后得到的变量会失去响应性。
比如这些情况,在 2s 后都得不到新的 name 信息:
ts
import { defineComponent, reactive } from 'vue'
interface Member {
id: number
name: string
}
export default defineComponent({
setup() {
// 定义一个带有响应性的对象
const userInfo: Member = reactive({
id: 1,
name: 'Petter',
})
// 在 2s 后更新 `userInfo`
setTimeout(() => {
userInfo.name = 'Tom'
}, 2000)
// 这个变量在 2s 后不会同步更新
const newUserInfo: Member = { ...userInfo }
// 这个变量在 2s 后不会再同步更新
const { name } = userInfo
// 这样 `return` 出去给模板用,在 2s 后也不会同步更新
return {
...userInfo,
}
},
})