好久沒有寫部落格了,剛好上週遇到一個難纏問題,這裡記錄一下。
環境:Vue3.2、Element Plus
問題:子元件 setting.vue => 彈窗元件 Dialog => 樹選擇元件el-tree-select ,無法設定預設選中項 default-checked-keys
場景:在一個後臺系統的列表頁,選中一行資料,點選設定按鈕,分配一些功能。這裡的做法是把設定頁封裝在一個子元件裡了,並且子元件裡使用了Element Plus的Dialog元件
然後Dialog裡有個el-tree-select需要初始化賦值,因為在分配之前,可能之前分配過,需要設定反選
最開始是直接寫死,如下:
<template>
<el-tree-select
:default-expanded-keys="['xxxxxxxx']" /> </template>
然後發現不生效,週五的時候也能猜到原因,data繫結的pinia全域性狀態裡的值,元件被範例化時這個值可能還未被載入,所以設定default-expanded-keys時它就找不到節點資料,等元件被建立後,data有值了,但是default-expanded-keys又不會再重新設定了,就造成元件有下拉資料,但是沒有反選效果。
起初以為是個簡單問題,於是動了動腦子,既然和順序有關,那自然考慮到生命週期了,於是在setting.vue里加上onMounted,並在這裡重新賦值:
<template>
<el-tree-select
:default-expanded-keys="selectArr"
/>
</template>
data繫結list這個變數,default-expanded-keys繫結selectArr。嗯,以為可以了,結果還是沒有反選成功。就.....離譜~
正常來講onMounted函數已經是元件建立完畢並建立Dom了,這個時候我應該可以設定list的值,再設定selectArr。但實際依然沒有反選成功。
這說明載入依然存在問題,抱著研究的心態,於是我又想起一種方法,我可以通過呼叫el-tree-select的API來通過方法設定它的預設值,也就是setCheckedKeys方法!
通過模板參照,獲取到el-tree-select,命名為tree,然後回到onMounted裡列印:console.log(tree.value),好傢伙,居然是個undefined,這說明在settting.vue的onMounted根本就無法設定選中的keys。然後詭異的是,在我反覆修改程式碼的時候,由於熱過載,Vue頁面會隨之更新,居然能反選上了!但是我一重新整理,反選立刻失效。enmmmm ..... 基本能定位到問題的所在了,onMounted是無法獲取到元件的,後面試了一下onUnmounted,這個可以,但是我這是初始化邏輯,不可能寫在onUnmounted裡。
這裡面還存在一個因素導致該問題的產生,就是Dialog預設是不顯示的,通過v-model="dialogVisible"繫結的變數控制顯示隱藏,初始化值為false也是導致失效的一個原因,如我初始時設定dialogVisible.value = true ,那麼反選是OK的,只不過我依然不可能設定為true,哪有彈窗一開始就顯示的。
週五下午基本卡在這個地方了,經過週末的放空自我(峽谷Timi),週一早上上班的路上覆盤了一下,考慮從Dialog本身尋找答案,嘿,果不其然,它的API裡有個opened方法,Dialog 開啟動畫結束時的回撥,我在這裡做初始化,問題就解決了:
// Dialog @opened="opened" // script ts const opened = () => { selectArr.value = ['xxxxxxxx'] }
之所以能找到這個思路,還有一個原因是也試了一下表單,之前表單的提交事件裡一直可以獲取到表單物件,然後試了一下onMounted裡能不能獲取到,結果也是類似的情況。放個按鈕,在按鈕的點選事件裡是可以獲取到元件的,因為等你可以點選按鈕時,頁面什麼東西都載入完畢了,同樣的,Dialog 開啟動畫結束時的回撥裡,頁面肯定早載入完畢了,該有的值都有了,那麼這個時候做初始化就不會存在找不到key的問題了。
這個問題看似簡單,最後opened方法搞定了,但實際很考驗Vue的功底,什麼時候元件被建立,什麼時候資料被載入,每個屬性之間資料的聯動以及先後順序,如果你寫個固定值放在data和keys那裡,肯定沒這個問題,Element Plus官方檔案大把的案例拿過來直接就有效果,但是呢,實際的專案開發中,經常是多個技術點綜合在一起,你基本不可能把一個下拉框的值寫死了,也許你和我一樣從pinia裡取的值,也許你通過axios讀的資料,也許是別的路子,但是多少會遇到一些和預期不符的時候,因此這裡以這個案例分享一下,自己也做個記錄,如果有人遇到了類似的問題可以參考一二,有更好的方案也可以提出來一起交流交流。
以上。