訴諸 Vue 組合式 API 解構(gòu) Props
大家好,這里是大家的林語冰。
響應(yīng)式 API 賦予了組合式 API 一大坨可能性的同時,代碼精簡。雖然但是,我們應(yīng)該意識到響應(yīng)性的某些陷阱,比如丟失響應(yīng)性。
在本文中,我們將學(xué)習(xí)如何正確解構(gòu) Vue 組件的 props,使得 props 不會丟失響應(yīng)性。
1. 解構(gòu) props
編譯器宏 defineProps() 可以輔助讀寫提供給 <script setup> 中的組件的 props:
圖片
上述示例中,props 是一個響應(yīng)式對象,包含了提供給組件的 props。如果組件 props 變化了,props 響應(yīng)式對象也會隨之變化。
讀寫 props 對象時,我們要做的第一件事可能是,解構(gòu) props 對象,然后讀寫各個屬性。但當(dāng)我學(xué)習(xí) Vue 組合式 API 時,令我大吃一驚的是,解構(gòu)的 props 丟失了響應(yīng)性!
讓我們來看一個例子。下述組件 <EvenOdd :count="5"> 接受 count 屬性作為數(shù)字,并顯示一條消息,無論 count 是偶數(shù)還是奇數(shù)。
在解構(gòu) props 對象 const { count } = defineProps() 之后,訪問該 count 屬性:
圖片
單擊幾次增加按鈕。您會注意到,盡管 count 屬性不斷累加,但 "The number is even" 消息始終保持不變。
當(dāng)解構(gòu) props 對象 const { count } = defineProps() 時,響應(yīng)性就會丟失。
響應(yīng)性之所以會丟失,是因?yàn)樵诮鈽?gòu)時 count 變異為具有原始值的變量(一個平平無奇的數(shù)字罷了)。但 Vue 的響應(yīng)性不能直接作用于原始值:Vue 必須訴諸 ref 或響應(yīng)式對象。
粉絲請注意,在 Vue 中將原始值直接賦值給變量時要小心:此乃丟失響應(yīng)性的前提。
2. 解決方案 1:使用“props”對象
第一個顯而易見的解決方案是,不要解構(gòu) props 對象,并使用屬性讀寫器直接讀寫 props: props.count。
圖片
上述示例中,讀寫 computed() 內(nèi)的 props.count 可以在 props.count 變更時保留響應(yīng)性。props 對象是響應(yīng)式的,對其進(jìn)行任何變更都會被正確追蹤。
這種方案的短板是,我們必須始終使用屬性讀寫器(比如 props.count)來讀寫 <script setup 中的 prop。
解決方案 2:使用 toRefs() 輔助函數(shù)
如果您閱讀至此,我敢打賭您是解構(gòu)賦值的忠實(shí)粉絲,并且沒有它就活不下去。
問題不大,那么您可以有意識地將 props 對象的每個屬性轉(zhuǎn)換為 ref,來保留解構(gòu) props 的響應(yīng)性。Vue 提供了一個特殊的輔助函數(shù) toRefs(reactiveObject) 來精準(zhǔn)完成此操作。
其工作機(jī)制如下:
圖片
toRefs(props) 返回一個對象,其中每個屬性都是對相應(yīng) prop 的 ref。
現(xiàn)在解構(gòu) const { count } = toRefs(props) 是安全的,因?yàn)?nbsp;count 是基于 count 屬性的 ref?,F(xiàn)在,每次 count 屬性變更時,count 的 ref 都會響應(yīng)屬性更改。
將 count 作為 ref,在 computed() 內(nèi),我們必須使用 count.value 讀寫 prop 的值(因?yàn)?nbsp;count.value 是我們讀寫 ref 的值的方式)。
我發(fā)現(xiàn)此方案可以方便地將 prop ref 作為參數(shù)傳遞給組合式函數(shù):比如 useMyComposable(count),并且不會丟失響應(yīng)性。
否則,我會堅(jiān)持之前的方案,直接使用 props 對象讀寫 prop。
4. 總結(jié)一下
粉絲請注意,通過應(yīng)用解構(gòu) const { propA, propB } = defineProps(),我們會丟失 props 的響應(yīng)性。
解決響應(yīng)性丟失的方案主要有兩種:
不解構(gòu) props,而是訴諸屬性讀寫器直接讀寫 props:比如 props.xxx/props.cat。
有意識地使用 props 作為 refs 的對象:const { propA, propB } = toRefs(props)。這保留了解構(gòu)后的響應(yīng)性。然后我們可以將屬性作為獨(dú)立 ref 讀寫,比如 propsA.value/propB.value 等。