前言 眾所周知,vue3的template中使用ref變數無需使用.value。還可以在事件處理器中進行賦值操作時,無需使用.value就可以直接修改ref變數的值,比如:<button @click="msg = 'Hello Vue3'">change msg</button>。你猜vue是在編 ...
前言
眾所周知,vue3的template中使用ref變數無需使用.value
。還可以在事件處理器中進行賦值操作時,無需使用.value
就可以直接修改ref變數的值,比如:<button @click="msg = 'Hello Vue3'">change msg</button>
。你猜vue是在編譯時就已經在代碼中生成了.value
,還是運行時使用Proxy攔截的方式去實現的呢?註:本文中使用的vue版本為3.4.19
。
關註公眾號:【前端歐陽】,給自己一個進階vue的機會
看個demo
看個簡單的demo,代碼如下:
<template>
<p>{{ msg }}</p>
<button @click="msg = 'Hello Vue3'">change msg</button>
</template>
<script setup lang="ts">
import { ref } from "vue";
const msg = ref("Hello World");
console.log(msg.value);
</script>
上面的代碼很簡單,在script中想要訪問msg
變數的值需要使用msg.value
。但是在template中將msg
變數渲染到p標簽上面時就是直接使用{{ msg }}
,在click
的事件處理器中給msg
變數賦新的值時也沒有使用到.value
。
然後在瀏覽器中找到上面這個vue文件編譯後的樣子,在之前的文章中已經講過很多次如何在瀏覽器中查看編譯後的vue文件,這篇文章就不贅述了。編譯後的代碼如下:
import {
Fragment as _Fragment,
createElementBlock as _createElementBlock,
createElementVNode as _createElementVNode,
defineComponent as _defineComponent,
openBlock as _openBlock,
toDisplayString as _toDisplayString,
ref,
} from "/node_modules/.vite/deps/vue.js?v=23bfe016";
const _sfc_main = _defineComponent({
__name: "index",
setup() {
const msg = ref("Hello World");
console.log(msg.value);
const __returned__ = { msg };
return __returned__;
},
});
function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) {
return (
_openBlock(),
_createElementBlock(
_Fragment,
null,
[
_createElementVNode("p", null, _toDisplayString($setup.msg), 1),
_createElementVNode(
"button",
{
onClick:
_cache[0] ||
(_cache[0] = ($event) => ($setup.msg = "Hello Vue3")),
},
"change msg"
),
],
64
)
);
}
_sfc_main.render = _sfc_render;
export default _sfc_main;
vue文件編譯後的代碼主要分為兩塊:_sfc_main
和_sfc_render
。
-
_sfc_main
中主要是setup方法,這個是vue的<script setup lang="ts">
部分編譯後的樣子。從上面可以看到在編譯後的setup方法中,訪問msg
變數時依然使用了msg.value
,並且在setup方法中return了{ msg }
對象。 -
_sfc_render
就是我們熟悉的render函數,在render函數中渲染p標簽部分的內容是:_toDisplayString($setup.msg)
。很明顯這個toDisplayString
就是一個將輸入值轉換為字元串的函數,並沒有處理.value
。$setup.msg
中的$setup.
,我想你猜到了應該和前面這個setup
方法中return的{ msg }
對象有關,但是又不是直接使用setup
方法中return的{ msg }
對象,因為使用setup中的msg
變數需要使用.value
,在編譯後的render函數中並沒有幫我們自動生成一個.value
,比如這樣的代碼:$setup.msg.value
。同樣的在render函數中,button的click事件給
msg
變數賦值時也沒有幫我們生成一個類似於這樣的代碼:$setup.msg.value = "Hello Vue3"
,而是$setup.msg = "Hello Vue3"
。從render函數中可以看出在template中使用ref變數無需使用
.value
,並不是編譯時就已經在代碼中生成了.value
,比如$setup.msg.value
,而是通過Proxy的方式去實現的。
render函數
在render函數中讀和寫msg
變數都變成了$setup.msg
,而這個$setup
對象又是調用render函數時傳入的第四個參數。現在我們需要搞清楚調用render函數時傳入的第四個參數到底是什麼?給render函數打一個斷點,刷新頁面,此時代碼走到了斷點裡面,如下圖:
右邊的Call Stack表示當前函數的調用鏈,從調用鏈中可以看到render函數是由一個名為renderComponentRoot
的函數調用的。
點擊Call Stack中的renderComponentRoot
,代碼會跳轉到renderComponentRoot
函數中,在我們這個場景中簡化後的renderComponentRoot
函數代碼如下:
function renderComponentRoot(instance) {
const {
props,
data,
setupState,
render: render2,
// 省略...
} = instance;
render2.call(
thisProxy,
proxyToUse,
renderCache,
props,
setupState,
data,
ctx
);
}
這裡的render2
也就是我們的render函數,由於使用了.call
,所以調用render函數時傳入的第四個參數為setupState
對象。而setupState
對象的值又是從instance.setupState
而來的。
通過debug調試render函數我們發現,在render函數中渲染msg
變數是使用$setup.msg
,而$setup
對象的值是從instance.setupState
對象上面來的。
前面講過了編譯後的setup
方法會返回一個包含msg
屬性的對象,而這個$setup
對象也就是instance.setupState
肯定是和setup
方法返回的對象有關係的。所以接下來我們需要去debug調試setup方法搞清楚他們到底是什麼關係。
setup方法
將render函數中的斷點去掉,然後給setup方法打一個斷點。刷新頁面,此時代碼會走到斷點中,如下圖:
同理在Call Stack中可以看到調用setup方法的是callWithErrorHandling
函數,點擊Call Stack中的callWithErrorHandling
,代碼會跳轉到callWithErrorHandling
函數中。代碼如下:
function callWithErrorHandling(fn, instance, type, args) {
try {
return args ? fn(...args) : fn();
} catch (err) {
handleError(err, instance, type);
}
}
從上面可以看到在callWithErrorHandling
函數中只是進行了錯誤處理,並不是我們想要找的。
setupStatefulComponent
函數
從Call Stack中可以看到調用callWithErrorHandling
函數的是setupStatefulComponent
函數,點擊Call Stack中的setupStatefulComponent
,代碼會跳轉到setupStatefulComponent
函數中。在我們這個場景中簡化後的setupStatefulComponent
函數代碼如下:
function setupStatefulComponent(instance) {
const Component = instance.type;
const { setup } = Component;
const setupResult = callWithErrorHandling(setup, instance);
handleSetupResult(instance, setupResult);
}
從上面的代碼可以看到確實是使用callWithErrorHandling
函數執行了setup方法,並且還將setup方法的返回值對象賦值給了setupResult
變數。然後以instance
(vue實例)和setupResult
(setup方法的返回值)為參數,調用了handleSetupResult
函數。
handleSetupResult
函數
將斷點走進handleSetupResult
函數,在我們這個場景中簡化後的handleSetupResult
函數代碼如下:
function handleSetupResult(instance, setupResult) {
instance.setupState = proxyRefs(setupResult);
}
我們在render函數中渲染msg
變數是使用$setup.msg
,而$setup
對象的值是從instance.setupState
對象上面來的。
現在我們已經找到了instance.setupState
是在這裡賦值的,它的值是proxyRefs
函數的返回結果。
proxyRefs
函數
將斷點走進proxyRefs
函數,代碼如下:
function proxyRefs(objectWithRefs) {
return isReactive(objectWithRefs)
? objectWithRefs
: new Proxy(objectWithRefs, shallowUnwrapHandlers);
}
這個isReactive
函數是vue暴露出來的一個API,它的作用是檢查一個對象是否是由 reactive() 或 shallowReactive() 創建的代理。
這裡的objectWithRefs
對象就是setup
方法的返回值對象,通過前面我們知道setup
方法的返回值對象就是一個普通的js對象,並不是reactive的。所以proxyRefs
函數會返回三目運算符冒號(:
)後面的表達式,也就是使用Proxy
創建的setup
方法返回值對象代理。
我們接著來看shallowUnwrapHandlers
裡面做了哪些事情,代碼如下:
const shallowUnwrapHandlers = {
get: (target, key, receiver) => unref(Reflect.get(target, key, receiver)),
set: (target, key, value, receiver) => {
const oldValue = target[key];
if (isRef(oldValue) && !isRef(value)) {
oldValue.value = value;
return true;
} else {
return Reflect.set(target, key, value, receiver);
}
},
};
這個handler包含get和set方法,會對setup的返回值對象進行攔截。
當在render函數中渲染p標簽時會去讀$setup.msg
,就會走到get的攔截中。在get方法中使用到了Reflect.get
方法和unref
函數。
-
Reflect.get(target, key, receiver)
的作用是獲取target
對象的key
屬性,在我們這裡就是獲取setup返回值對象的msg
屬性,也就是我們定義的msg
變數。並且這個msg
變數是一個ref。 -
將
Reflect.get
方法拿到的msg
變數傳給unref
函數,這個unref
函數同樣是暴露出來的一個API。如果參數是 ref,則返回內部值,否則返回參數本身。這是val = isRef(val) ? val.value : val
計算的一個語法糖。經過
unref
函數的處理後,在get攔截中return的就是.value
後的內容,也就是msg.value
。所以在template中使用ref變數無需使用
.value
,是因為在Proxy的get攔截中已經幫我們自動處理了.value。
當在render函數中去對ref變數進行賦值,比如:<button @click="msg = 'Hello Vue3'">change msg</button>
。
就會走到set攔截中,首先會執行const oldValue = target[key]
。這裡的key就是"msg",target就是setup函數返回值對象。使用oldValue
就是msg
變數,是一個ref。
由於我們在click事件中要將msg
賦值成'Hello Vue3'字元串,所以在set攔截中拿到的新value為'Hello Vue3'字元串。
接著執行if (isRef(oldValue) && !isRef(value))
判斷,這裡的oldValue
前面已經講過了是一個名為msg
的ref變數,所以isRef(oldValue)
為true。value
為'Hello Vue3'字元串,所以!isRef(value)也是為true。
代碼就會走進if判斷中執行oldValue.value = value
,也就是在執行msg.value = 'Hello Vue3'
。
所以在template中給ref變數賦值無需使用.value
,是因為在Proxy的set攔截中也幫我們自動處理了.value
。
總結
整個流程圖如下:
在vue3的template中使用ref變數無需使用.value
,是因為有個Proxy的get攔截,在get攔截中會自動幫我們去取ref變數的.value
屬性。
同樣的在template中對ref變數進行賦值也無需使用.value
,也是有個Proxy的set攔截,在set攔截中會自動幫我們去給ref變數的.value
屬性進行賦值。
關註公眾號:【前端歐陽】,給自己一個進階vue的機會