DIV CSS 佈局教程網

JavaScript 實作 TreeView 核取框連動(無需回傳伺服器)
編輯:關於JavaScript     

樹狀選單的核取框連動是個經典需求,規則有兩條:

  • 往上連動:子節點被勾選,則所有父節點自動勾選。
  • 往下連動:父節點被取消勾選,則所有子節點取消勾選。

以下範例用純 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。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved