基础类型的响应性 —— ref
在vue3里面,我们可以通过 reactive 来实现引用类型的响应性,那么基础类型的响应性如何来实现呢?
可能你会想到这样来实现:
const count = reactive({value: 0}) count.value += 1 复制代码
这么做确实可以实现,而且也很像 ref 的使用方式,都是要 .value 嘛。那么 ref内部 是不是这么实现的呢?
我们先定义两个 ref 的实例并且打印看看。
const refCount = ref(0) // 基础类型 console.log('refCount ', refCount ) const refObject = ref({ value: 0 }) // 引用类型 console.log('refObject ', refObject ) 复制代码
看一下结果:
我们都知道 reactive 是通过 ES6 的 Proxy 来实现的,基础类型的 ref 显然和 Proxy 没啥关系,而引用类型的 ref 是先把原型变成 reactive, 然后再挂到 value 上面。 这样看来,和我们的猜测不太一样呢,那么 ref 到底是如何实现的呢?我们可以看一下 ref 的源码。
ref 的源码
代码来自于 vue.global.js ,调整了一下先后顺序。
function ref(value) { return createRef(value); } function createRef(rawValue, shallow = false) { if (isRef(rawValue)) { return rawValue; } return new RefImpl(rawValue, shallow); } class RefImpl { constructor(_rawValue, _shallow = false) { this._rawValue = _rawValue; this._shallow = _shallow; this.__v_isRef = true; this._value = _shallow ? _rawValue : convert(_rawValue); // 深层 ref or 浅层ref } get value() { track(toRaw(this), "get" /* GET */, 'value'); return this._value; } set value(newVal) { if (hasChanged(toRaw(newVal), this._rawValue)) { this._rawValue = newVal; this._value = this._shallow ? newVal : convert(newVal); trigger(toRaw(this), "set" /* SET */, 'value', newVal); } } } const convert = (val) => isObject(val) ? reactive(val) : val; 复制代码
- ref
这是我们使用的函数,里面使用 createRef 来创建一个实例。
- createRef
做一些基础判断,然后进入主题,正式创建ref。这里还可以创建 shallowRef。
- RefImpl
这个才是主体,显然这是 ES6 的 class,constructor 是初始化函数,依据参数创建一个实例,并且设置实例的属性。这个和上面 ref 的打印结果也是可以对应上的。 整个class的代码也是非常简单,设置几个“内部”属性,记录需要的数据,然后设置“外部”属性 value,通过setter、getter 实现对 value 的操作拦截,set 里面主要是 trigger 这个函数,由它调用模板的自动刷新的功能。
- convert
很显然,判断一下参数是不是 object,如果是的话,变成 reactive 的形式。 这个就可以解释,引用类型的 ref 是如何实现响应性的,明显是先变成 reactive,然后在挂到 value 上面(挂之前判断一下是不是浅层的)。
ref 和 reactive 的关系
通过打印结果的对比以及分析源码可以发现:
- 基础类型的 ref 和 reactive 没有任何关系。
- 引用类型的 ref ,先把 object 变成 reactive ,即利用 reactive 来实现引用类型的响应性。
关系就是这样的,千万不要再混淆了。
shallowRef
浅层响应式,只监听 .value 的变化,真简单类型的响应式。
function shallowRef(value) { return createRef(value, true); // true 浅层 } 复制代码
通过源码我们可以发现,在把引用类型挂到 value 之前,先判断一下是不是浅层的,如果是浅层的,并不会变成 reactive,而是直接把原来的对象挂在 value 上面,shallowRef 和 ref 的区别就在于这一点。
我们写几个实例看看效果:
setup () { // 浅层的测试 // 基础类型 const srefCount = shallowRef(0) console.log('refCount ', srefCount ) // 引用类型 const srefObject = shallowRef({ value: 0 }) console.log('refObject ', srefObject ) // 嵌套对象 const srefObjectMore = shallowRef({ info: {a: 'jyk'} }) console.log('shallowRef ', srefObjectMore ) // reactive 的 shallowRef const ret = reactive({name: 'jyk'}) const shallowRefRet = shallowRef(ret) console.log('shallowRefRet ', shallowRefRet ) // ==================== 事件 ================== // 修改基础类型 const setNumber = () => { srefCount.value = new Date().valueOf() console.log('srefCount ', srefCount ) } // 修改引用类型的属性 const setObjectProp = () => { srefObject.value.value = new Date().valueOf() console.log('srefObject ', srefObject ) } // 修改引用类型的value const setObject = () => { srefObject.value = { value: new Date().valueOf() } console.log('srefObject ', srefObject ) } // 修改嵌套引用类型的属性 const setObjectMoreProp = () => { srefObjectMore.value.info.a = new Date().valueOf() console.log('srefObjectMore ', srefObjectMore ) } // 修改嵌套引用类型的value const setObjectMore = () => { srefObjectMore.value = { qiantao: 1234567 } console.log('srefObjectMore ', srefObjectMore ) } // 修改reactive 的浅层ref const setObjectreactive = () => { shallowRefRet.value.name = '浅层的reactive' console.log('shallowRefRet ', shallowRefRet ) } } 复制代码
看看结果:
测试了一下响应性:
- 基础类型 srefCount 有响应性;
- 引用类型 srefObject 的属性没有响应性,但是直接修改 .value 是有响应性的。
- 嵌套的引用类型 srefObjectMore ,属性和嵌套属性都是没有响应性的,但是直接修改 .value 是有响应性的。
- reactive 套上 shallowRef ,然后修改 shallowRef.value.属性 = xxx ,也是可以响应的,所以浅层的ref 也不绝对,还要看内部结构。
triggerRef
手动执行与 shallowRef 关联的任何效果。
官网的中文版里面写的很绕,其实就是 让 shallowRef 原本不具有响应性的部分,具有响应性。 shallowRef 是浅层的,深层部分是没有响应性的,那么如果非得让这部分也具有响应性呢? 这时候可以用 triggerRef 来实现。 好吧,目前还没有想到有啥具体的应用场景,因为一般都直接简单粗暴的用 ref 或者 reactive 了,全都自带响应性。
测试了各种情况,发现 triggerRef 并不支持 shallowReactive,还以为能支持呢。(或许是我写的测试代码有问题吧,官网也没提 shallowReactive)
基于上面的例子,在适当的位置加上 triggerRef(xxx)就可以了。
setup () { // 引用类型 const srefObject = shallowRef({ value: 0 }) // 嵌套对象 const srefObjectMore = shallowRef({ value: {a: 'jyk'} }) // reactive 的 shallowRef const ret = reactive({name: 'reactive'}) const shallowRefRet = shallowRef(ret) // 浅层的reactive const myShallowReactive = shallowReactive({info:{name:'myShallowReactive'}}) const setsRet = () => { myShallowReactive.info.name = new Date().valueOf() triggerRef(myShallowReactive) // 修改后使用,不支持 } // ==================== 事件 ================== // 修改引用类型的属性 const setObjectProp = () => { srefObject.value.value = new Date().valueOf() triggerRef(srefObject) // 修改后使用 } // 修改引用类型的value const setObject = () => { srefObject.value = { value: new Date().valueOf() } triggerRef(srefObject) } // 修改嵌套引用类型的属性 const setObjectMoreProp = () => { srefObjectMore.value.value.a = new Date().valueOf() triggerRef(srefObjectMore) } // 修改嵌套引用类型的value const setObjectMore = () => { srefObjectMore.value.value = { value: new Date().valueOf() } triggerRef(srefObjectMore) } // 修改reactive 的浅层ref const setObjectreactive = () => { shallowRefRet.value.name = '浅层的reactive' + new Date().valueOf() triggerRef(shallowRefRet) } return { srefObject, // 引用类型 srefObjectMore, // 嵌套引用类型 shallowRefRet, // reactive 的浅层ref myShallowReactive, // 浅层的reactive setsRet, // 修改浅层的reactive setObjectProp, // 修改引用类型的属性 setObject, // 修改引用类型的value setObjectMoreProp, // 修改嵌套引用类型的属性 setObjectMore, // 修改嵌套引用类型的value setObjectreactive // 试一试reactive的浅层ref } } 复制代码
深层部分,不使用 triggerRef 就不会刷新模板,使用了 triggerRef 就可以刷新模板。 话说,为啥会有这个函数?
isRef
通过 __v_isRef 属性 判断是否是 ref 的实例。这个没啥好说的。 vue.global.js 源码:
function isRef(r) { return Boolean(r && r.__v_isRef === true); } 复制代码
unref
- 使用.value的语法糖
unref 是一个语法糖,判断是不是 ref 的,如果是则取.value,不是的话取原型。 vue.global.js 源码:
function unref(ref) { return isRef(ref) ? ref.value : ref; } 复制代码
- unref 的用途
普通对象直接.属性
即可使用,但是 ref 却需要.value才可以,混合使用的时候容易晕头,尤其在函数内部接收参数的时候,无法确定传入的是 reactive 还是 ref,如果每次都用 isReactive 或者 isRef 来判断类型,然后决定是否用.value,那就太麻烦了。于是有了这个语法糖。
toRef 和 toRefs
toRef 可以用来为源响应式对象上的 property 性创建一个
ref
。然后可以将 ref 传递出去,从而保持对其源 property 的响应式连接。
toRefs 将响应式对象转换为普通对象,其中结果对象的每个 property 都是指向原始对象相应 property 的ref
。
话说,官网的解释为啥总是这么令人费解呢? 我们还是先看看例子
setup () { /** * 定义 reactive * 直接解构属性,看响应性 * 使用toRef解构,看响应性 * 使用toRefs解构,看响应性 * 按钮只修改reactive */ const person = reactive({ name: 'jyk', age: 18 }) console.log('person ', person ) // 直接获取属性 const name = person.name console.log('name ', name ) const refName = toRef(person, 'name') console.log('refName ', refName ) const personToRefs = toRefs(person) console.log('personToRefs ', personToRefs ) const update = () => { // 修改原型 person.name = new Date() } return { person, // reactive name, // 获取属性 refName, // 使用toRef personToRefs, update // 修改属性 } } 复制代码
当我们修改person的属性值的时候,toRef 和 toRefs 的实例也会自动变化。而直接获取的name属性并不会变化。
toRef 就是想实现直接使用对象的属性名,并且仍然享有响应性的目的。 toRef 就是对reactive 进行解构,然后仍然享有响应性的目的。
其实,说是变成了ref,但是我们看看打印结果就会发现,其实并不完全是ref。
看类名和属性,toRef 和 ref 也是有区别的。
toRef 为啥可以响应
toRef 也是一个语法糖。
如果使用常规的方式对 reactive 进行解构的话就会发现,虽然解构成功了,但是也失去响应性(仅限于基础类型的属性,嵌套对象除外)。
那么如何实现解构后还具有响应性呢?这时候就需要使用 toRef 了。
看上面那个例子,使用 refName 的时候,相当于使用 person['name'],这样就具有响应性了。
你可能会问,就这?对就是这么简单,不信的话,我们来看看源码:
function toRef(object, key) { return isRef(object[key]) ? object[key] : new ObjectRefImpl(object, key); } class ObjectRefImpl { constructor(_object, _key) { this._object = _object; this._key = _key; this.__v_isRef = true; } get value() { return this._object[this._key]; // 相当于 person['name'] } set value(newVal) { this._object[this._key] = newVal; } } 复制代码
看 get 部分,是不是 相当于 person['name'] ?
另外,虽然 toRef 看起来好像是变成了 ref,但是其实只是变成了 ref (RefImpl)的双胞胎兄弟(ObjectRefImpl),并没有变成 ref(RefImpl)。 ref 是 RefImpl, 而 toRef 是 ObjectRefImpl,这是两个不同的class 。 toRef 可以看做是 ref 同系列的 class,后面还有一个同系列的。
toRefs
了解 toRef 之后,toRefs 就好理解了,从表面上看,可以把 reactive 的所有属性都解构出来,从内部代码来看,就是把多个 toRef 放在了数组(或者对象)里面。
function toRefs(object) { if ( !isProxy(object)) { console.warn(`toRefs() expects a reactive object but received a plain one.`); } const ret = isArray(object) ? new Array(object.length) : {}; for (const key in object) { ret[key] = toRef(object, key); } return ret; } 复制代码
customRef
自定义一个ref,并对其依赖项跟踪和更新触发进行显式控制。它需要一个工厂函数,该函数接收 track 和 trigger 函数作为参数,并应返回一个带有 get 和 set 的对象。
如果上面那段没看懂的话,可以跳过。
简单的说,就是在 ref 原有的 set、get 的基础上,加入我们自己写的代码,以达到一定的目的。
话说,官网写的例子还真是…… 反正一开始我是没看懂,后来又反复看,又把代码敲出来运行,又查了一下“debounce”的意思。 最后终于明白了,这是一个防抖(延迟响应)的代码。
一般用户在文本框里输入内容,立即就会响应,但是如果在查询功能里面的话就会有点小郁闷。 用户输入个“1”,立即就去后端查询“1”, 然后用户又输入个“2”,立即又去后端查询“12”, 然后用户又输入个“3”,立即又去后端查询“123”。 …… 这个响应是很快,但是有点“折腾”的嫌疑,那么能不能等用户把“123”都输入好了,再去后端查询呢?
官网的例子就是实现这样的功能的,我们把例子完善一下,就很明显了。
const useDebouncedRef = (value, delay = 200) => { let timeout return customRef((track, trigger) => { return { get() { track() // vue内部的跟踪函数 return value }, set(newValue) { clearTimeout(timeout) timeout = setTimeout(() => { value = newValue trigger() // vue内部的自动更新的函数。 }, delay) // 延迟时间 } } }) } setup () { const text = useDebouncedRef('hello', 1000) // 定义一个 v-model console.log('customRef', text) const update = () => { // 修改后延迟刷新 text.value = '1111' + new Date().valueOf() } return { text, update } } 复制代码
customRef 对象:{{text}} <br><br> <input v-model="text" type="text"> 复制代码
- get
没有改变,直接用原方法。
- set
使用 setTimeout 实现延迟响应的功能,把 Vue 内部的 trigger() 放在 setTimeout 里面就好。
这样就可以了,延迟多长的时间可以自定义,这里是一秒。一秒内用户输入的内容,会一次性更新,而不是每输入一个字符就更新一次。
- v-model="text"
可以作为 v-model 来使用。
customRef 的 源码
我们再来看看 customRef 内部源码的实现方式。
function customRef(factory) { return new CustomRefImpl(factory); } class CustomRefImpl { constructor(factory) { this.__v_isRef = true; const { get, set } = factory(() => track(this, "get" /* GET */, 'value'), () => trigger(this, "set" /* SET */, 'value')); this._get = get; this._set = set; } get value() { return this._get(); } set value(newVal) { this._set(newVal); } } 复制代码
很简单的是不是,就是先这样,然后在那样,最后就搞定了。 好吧,就是把 factory参数解构出来,分成set和get,做成内部函数,然后在内部的set和get里面调用。
自定义 ref 的实例 —— 写一个自己的计算属性。
一提到计算属性,我们会想到 Vue 提供的 computed,那么如果让我们使用自定义ref 来实现计算属性的功能的话,要如何实现呢?(注意:只是练习用)
我们可以这样来实现:
const myComputed = (_get, _set) => { return customRef((track, trigger) => { return { get() { track() if (typeof _get === 'function') { return _get() } else { console.warn(`没有设置 get 方法`) } }, set(newValue) { if (typeof _set === 'function') { _set(newValue) trigger() } else { console.warn(`没有设置 set 方法`) } } } }) } setup () { const refCount = ref(0) const myCom = myComputed(() => refCount.value + 1) // const myCom = myComputed(() => refCount.value, (val) => { refCount.value = val}) const update = () => { // 修改原型 refCount.value = 3 } const setRef = () => { // 直接赋值 refCount.value += 1 } return { refCount, // 基础类型 myCom, // 引用类型 update, // 修改属性 setRef // 直接设置 } } 复制代码
<div> 展示 自定义 的 customRef 实现计算属性 <br> ref 对象:{{refCount}} <br><br> 自定义的计算属性 对象:{{myCom}} <br><br> <input v-model="myCom" type="text"> <el-button @click="update" type="primary">修改属性</el-button><br><br> </div> 复制代码
- myComputed
首先定义一个函数,接收两个参数,一个get,一个set。
- customRef
返回一个 customRef 的实例,内部设置get 和 set。
- 调用方法
调用的时候,可以只传入get函数,也可以传入get、set两个函数。 修改 refCount.value 的时候,v-model 的 myCom 也会发生变化。
- 实用性
那么这种方式有啥使用效果呢? 在做组件的时候,组件的属性props是不能直接用在内部组件的 v-model 里面的,因为props只读,那么怎么办呢?
可以在组件内部设置一个ref,然后对props做监听,或者用computed来做。 除了上面的几种方法外,也可以用这里的方法来实现,把 refCount 变成 props 的属性就可以了,然后set里面使用 smit 提交。
computed
写完了自己的计算属性后,我们还是来看看 Vue 提供的计算属性。 代码来自于 vue.global.js ,调整了一下先后顺序。
function computed(getterOrOptions) { let getter; let setter; if (isFunction(getterOrOptions)) { getter = getterOrOptions; setter = () => { console.warn('Write operation failed: computed value is readonly'); } ; } else { getter = getterOrOptions.get; setter = getterOrOptions.set; } return new ComputedRefImpl(getter, setter, isFunction(getterOrOptions) || !getterOrOptions.set); } class ComputedRefImpl { constructor(getter, _setter, isReadonly) { this._setter = _setter; this._dirty = true; this.__v_isRef = true; this.effect = effect(getter, { lazy: true, scheduler: () => { if (!this._dirty) { this._dirty = true; trigger(toRaw(this), "set" /* SET */, 'value'); } } }); this["__v_isReadonly" /* IS_READONLY */] = isReadonly; } get value() { if (this._dirty) { this._value = this.effect(); this._dirty = false; } track(toRaw(this), "get" /* GET */, 'value'); return this._value; } set value(newValue) { this._setter(newValue); } } 复制代码
- computed
暴露给我们用的方法,来定义一个计算属性。只有一个参数,可以是一个函数(function),也可以是一个对象。内部会做一个判断,然后做拆分。
- ComputedRefImpl
是不是有点眼熟?这个是 ref 同款系列,都是 RefImpl 风格的,而且内部代码结构也很相似。 这个是computed 的主体类,也是先定义内部属性,然后设置value的get和set。在get和set里面,调用外部设置的函数。
源码:
在线演示:
naturefw.gitee.io/nf-vue-cdn/…