本文分享一個 Vue 多層級多選選單元件的實作過程,重點在於如何用「子項選取了什麼」反推出父層與全選框該勾選還是取消。

歸納起來,核心就是:依子列表的勾選狀況計算出父標題與底部全選框的狀態;反過來,當父標題或全選框被操作時,子列表也要跟著改變。實作步驟如下。
datas : [
{
// 用於判斷是否展開子列表
isShowListItem : false,
// 用於記錄選中了哪些子項
selected : [],
// 父標題
listTitle : "保利南悅灣",
// 子列表
listItem : [
{ id : 1, name : "李小龍" },
{ id : 2, name : "周星馳" },
{ id : 3, name : "周傑倫" }
]
},
{
isShowListItem : false,
selected : [],
listTitle : "南莊萬科城",
listItem : [
{ id : 4, name : "大魔王" },
{ id : 5, name : "老妖怪" }
]
}
]
每個父層各自維護一個 selected 陣列,這是後續所有狀態判斷的基礎。
子列表用 v-model="data.selected" 雙向綁定到 selected 陣列,當某個子項的 checked 改變時,它的 id 就會被記進陣列裡:
<input type="checkbox" :value="item.id" v-model="data.selected" >
父標題的 HTML 綁了兩個東西::checked="isTitleChecked(data)" 讓它在任何項目變動時重新計算自己的狀態,達到依子項勾選數量自動變化的效果;@change="changeTitleChecked(data,$event)" 則負責回應使用者主動勾選或取消。
<input :id="data.listTitle" class="list-input" type="checkbox" :checked="isTitleChecked(data)" @change="changeTitleChecked(data,$event)" >
changeTitleChecked:使用者主動觸發父標題時,若這次的 checked 為 true,就把子列表中尚未選中的項目全部補進 selected;若為 false,則清空 selected。
isTitleChecked:子列表全數選中時自動勾選父標題。
/**
* 當父標題狀態變化時的處理方法
* @param data [當前項的 data]
* @param event [當前項的 event]
*/
changeTitleChecked : function (data,event) {
if (event.target.checked === true) {
data.listItem.forEach(function (item) {
data.selected.indexOf(item.id) === -1 && data.selected.push(item.id);
})
} else {
data.selected = [];
}
}
/**
* 判斷父標題選擇狀態
* @param data [當前項的 data]
* @returns {boolean}
*/
isTitleChecked : function (data) {
var _selected = data.selected;
var _listItem = data.listItem;
// 驗證 selected 中是否含有全部 item 的 id,如果是,證明 title 要選中
return _listItem.every(function (item) {
return _selected.indexOf(item.id) != -1;
});
}
全選框 HTML:
<input id="all-checked" type="checkbox" :checked="isAllChecked()" @change="changeAllChecked($event)" >
changeAllChecked:主動觸發時,若 checked 為 true 就把所有子項都放進各自的 selected;否則全部清空。
isAllChecked:判斷每個父層的 selected 長度是否等於其子項總數,全部相等時全選框才勾選。
/**
* 全選框 change 事件的回呼處理方法
* @param event
*/
changeAllChecked : function (event) {
if (event.target.checked === true) {
this.datas.forEach(function (data) {
data.listItem.forEach(function (item) {
data.selected.indexOf(item.id) === -1 && data.selected.push(item.id);
})
})
} else {
this.datas.forEach(function (data) {
data.selected = [];
})
}
}
/**
* 判斷全選框選擇狀態
* @returns {boolean}
*/
isAllChecked : function () {
return this.datas.every(function (data) {
return data.selected.length === data.listItem.length;
});
}
整個元件之所以能保持一致,是因為只維護一份真相:每個父層的 selected 陣列。父標題與全選框的勾選狀態都不是自己存的,而是每次渲染時即時算出來的(:checked 綁函式呼叫),因此不需要額外同步,也不會出現父子狀態打架的情形。這也是這類「層層聯動」需求最省力的思路。