萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 樹狀插件 zTree 入門教程:從引入到自定義節點互動

zTree 是一款功能強大的 jQuery 樹狀選單插件,支援核心樹結構、複選框、編輯、拖拽等擴展。本文以實際專案需求為例,詳細說明如何引入 zTree、配置設定、實現「滑鼠懸停顯示全選按鈕」與「點擊節點自動填入收件人框」等進階互動。

1. 引入必要檔案

至少需載入核心 JS 與 CSS;若需複選或編輯功能,再引入對應擴展包:

<script src="js/jquery-1.4.4.min.js"></script>
<script src="js/jquery.ztree.core-3.5.js"></script>
<script src="js/jquery.ztree.excheck-3.5.js"></script> <!-- 複選框功能 -->
<script src="js/jquery.ztree.exedit-3.5.js"></script> <!-- 編輯功能 -->
<link rel="stylesheet" href="css/zTreeStyle/zTreeStyle.css" type="text/css">

2. 核心設定

zTree 透過 setting 物件配置行為。以下範例啟用滑鼠懸停自定義按鈕(addHoverDom、removeHoverDom)與點擊回調(beforeClick、onClick):

var setting = {
    view: {
        addHoverDom: addHoverDom,
        removeHoverDom: removeHoverDom
    },
    callback: {
        beforeClick: beforeClick,
        onClick: onClick
    }
};

回調函式說明

  • beforeClick:點擊前觸發,可在此攔截或修改資料。範例中檢查收件人框是否已包含該節點資訊,若無則追加「名稱<電話>」格式字串。
  • onClick:點擊後觸發,若 beforeClick 回傳 false 則不會執行。

3. 滑鼠懸停顯示「全選」按鈕

僅對一級目錄(treeNode.parentNode.id != 1 且有子節點)顯示「全選」連結,點擊後遍歷所有子節點並呼叫 allSelect() 批次加入收件人框:

function addHoverDom(treeId, treeNode) {
    if (!treeNode.children) return;
    if (treeNode.parentNode && treeNode.parentNode.id != 1) return;

    var aObj = $("#" + treeNode.tId + "_a");
    if ($("#diyBtn1_" + treeNode.id).length > 0) return;

    var editStr = "<a id='diyBtn1_" + treeNode.id + "' style='margin:0 0 0 5px;color:red;'>全選</a>";
    aObj.append(editStr);
    document.getElementById("diyBtn1_" + treeNode.id).onclick = function() {
        allSelect(treeNode);
    };
}

function allSelect(treeNode) {
    if (!treeNode.children) return;
    for (var i = 0; i < treeNode.children.length; i++) {
        var phone = treeNode.children[i].phone;
        var re = new RegExp(phone);
        var accept = $("#accept").val();
        if (!re.test(accept)) {
            $("#accept").val(accept + treeNode.children[i].name + "<" + phone + ">,");
        }
    }
}

function removeHoverDom(treeId, treeNode) {
    if (!treeNode.children) return;
    $("#diyBtn1_" + treeNode.id).unbind().remove();
}

4. 節點資料結構

zTree 接受標準 JSON 陣列,每個節點可自訂屬性(如 phone、age 等)。範例展示靜態資料與 JSP 動態生成兩種方式:

var zNodes = [
    { id:1, name:"所有老師", open:false,
        children: [
            { id:2, name:"測試老師", phone:"123456789101" },
            { id:3, name:"大老師", phone:"15623545621" }
        ]
    },
    { id:4, name:"一班", open:true,
        children: [
            { id:5, name:"小花", phone:"25364215211" },
            { id:6, name:"小綠", phone:"365241253" }
        ]
    },
    { id:7, name:"二班", open:true,
        children: [
            { id:8, name:"小家", phone:"25364215211" },
            { id:9, name:"小沙", phone:"365241253" }
        ]
    }
];

5. 初始化樹

$(document).ready(function(){
    $.fn.zTree.init($("#treeDemo"), setting, zNodes);
});

小結

zTree 透過模組化設計,讓開發者能按需載入功能,並提供豐富的回調與事件機制,極適合構建複雜的樹狀介面。本文示範的「懸停全選」與「點擊收集資料」模式,可直接套用於通訊錄選擇、權限樹勾選等實務場景。

copyright © 萬盛學電腦網 all rights reserved