樹狀選單的核取框連動是個經典需求,規則有兩條:
以下範例用純 JavaScript 遞迴實作,完全在前端完成,不必回伺服器。
function public_GetParentByTagName(element, tagName) {
var parent = element.parentNode;
var upperTagName = tagName.toUpperCase();
// 如果這個元素還不是想要的 tag,就繼續往上找
while (parent && (parent.tagName.toUpperCase() != upperTagName)) {
parent = parent.parentNode ? parent.parentNode : parent.parentElement;
}
return parent;
}
這個工具函式沿著 DOM 樹往上走,直到找到指定標籤名的祖先。同時判斷 parentNode 與 parentElement 是為了相容舊版 IE。
// 子節點可訪問,則其父節點也必能訪問
function setParentChecked(objNode) {
var objParentDiv = public_GetParentByTagName(objNode, "div");
if (objParentDiv == null || objParentDiv == "undefined") {
return;
}
var objID = objParentDiv.getAttribute("ID");
objID = objID.substring(0, objID.indexOf("Nodes"));
objID = objID + "CheckBox";
var objParentCheckBox = document.getElementById(objID);
if (objParentCheckBox == null || objParentCheckBox == "undefined") {
return;
}
if (objParentCheckBox.tagName != "INPUT" || objParentCheckBox.type != "checkbox") {
return;
}
objParentCheckBox.checked = true;
setParentChecked(objParentCheckBox); // 遞迴往上
}
關鍵在最後那行遞迴:勾上父節點後,再對父節點呼叫自己,一路連動到根節點。
id 的命名慣例是這段程式的基礎:子節點容器叫 xxxNodes,對應的核取框叫 xxxCheckBox。程式透過字串替換在兩者之間轉換。原範例把條件寫成 tagName!="INPUT" && type=="checkbox",用 && 代表「不是 input 且 是 checkbox」——這兩個條件互斥,永不成立,等於這道防呆完全無效。上面已修正為 ||。
// 該節點不可訪問,則其子節點也不能訪問
function setChildUnChecked(divID) {
var objchild = divID.children;
for (var i = 0; i < objchild.length; i++) {
var tempObj = objchild[i];
if (tempObj.tagName == "INPUT" && tempObj.type == "checkbox") {
tempObj.checked = false;
}
setChildUnChecked(tempObj); // 遞迴往下
}
}
// 該節點可以訪問,則其子節點也都能訪問
function setChildChecked(divID) {
var objchild = divID.children;
for (var i = 0; i < objchild.length; i++) {
var tempObj = objchild[i];
if (tempObj.tagName == "INPUT" && tempObj.type == "checkbox") {
tempObj.checked = true;
}
setChildChecked(tempObj);
}
}
這兩個函式結構完全相同,只有赋值的方向不同。實務上可以合併成一個帶參數的函式:
function setChildren(divID, checked){
Array.prototype.forEach.call(divID.children, function(el){
if (el.tagName === 'INPUT' && el.type === 'checkbox'){
el.checked = checked;
}
setChildren(el, checked);
});
}
function CheckEvent() {
var objNode = event.srcElement;
if (objNode.tagName != "INPUT" || objNode.type != "checkbox") return;
if (objNode.checked == true) {
setParentChecked(objNode);
var objID = objNode.getAttribute("ID");
objID = objID.substring(0, objID.indexOf("CheckBox"));
var objParentDiv = document.getElementById(objID + "Nodes");
if (objParentDiv == null || objParentDiv == "undefined") return;
setChildChecked(objParentDiv);
} else {
var objID = objNode.getAttribute("ID");
objID = objID.substring(0, objID.indexOf("CheckBox"));
var objParentDiv = document.getElementById(objID + "Nodes");
if (objParentDiv == null || objParentDiv == "undefined") return;
setChildUnChecked(objParentDiv);
}
}
兩個分支裡取得 objParentDiv 的程式碼完全相同,可以提到 if 之前先做一次,減少重複。
this.tvPrivilege.Attributes.Add("OnClick", "CheckEvent()");
ASP.NET Web Forms 的 TreeView 控制項在渲染時會加上這行,讓每個核取框被點擊時都觸發 CheckEvent。
這個實作缺少一個實務上幾乎必備的功能:第三種狀態。當父節點的子公司只有部分被勾選時,父節點應該顯示「半選」(indeterminate)而非全不勾,否則使用者無法從父節點判斷下面的狀態。
// 更新父節點狀態:全選 / 半選 / 全不選
function refreshParent(node){
var parent = node.parentNode.closest('li');
if (!parent) return;
var boxes = parent.querySelectorAll(':scope > ul input[type=checkbox]');
if (!boxes.length) return;
var checked = Array.prototype.filter.call(boxes, b => b.checked).length;
var box = parent.querySelector(':scope > input[type=checkbox]');
if (box){
box.checked = checked === boxes.length;
box.indeterminate = checked > 0 && checked < boxes.length;
}
refreshParent(parent);
}
另外還有幾點要注意:event.srcElement 是 IE 專屬寫法,標準寫法是 event.target 或在函式參數中取 e.target;children 只取元素節點不含文字節點,這在這裡剛好合用,但要確定 DOM 結構中沒有包一層純文字;每次點擊都走完整棵子樹遞迴,節點多時會有效能壓力,可考慮在資料層維護狀態而非每次重算 DOM。