萬盛學電腦網

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

jQuery zTree 異步加載動態樹形選單完整實作範例

前言

zTree 是經典的 jQuery 樹形選單插件,支援異步加載、複選、拖拽、編輯等豐富功能。本文提供一個完整的「業務類型樹」實作範例,涵蓋設定檔、異步參數、回調事件、節點過濾與前端初始化代碼。

完整初始化代碼

<div class="zTreeDemoBackground left">
    <ul id="coagencyTree" class="ztree" style="height: 640px"></ul>
</div>

<!-- 隱藏欄位儲存選中節點資訊 -->
<input type="hidden" id="coagencyId" name="coagencyForm.coagencyId">
<input type="hidden" id="parentId"   name="coagencyForm.parentId">

<script>
// 1. 設定物件
var settingOther = {
    edit: { enable: false },                    // 不進入編輯模式
    async: {                                    // 異步加載配置
        enable: true,
        url: "initCoagencyTree.action",         // 後端端點
        autoParam: ["id", "name=n"],            // 發送參數:id, name=n
        otherParam: { "otherParam": "zTreeAsyncTest" },
        dataFilter: filter                      // 回調:預處理回傳資料
    },
    data: {
        simpleData: { enable: true }            // 使用簡單陣列格式 {id, pId, name}
    },
    callback: {
        beforeClick: beforeClick,               // 點擊前攔截
        onClick: onClick                        // 點擊後處理
    }
};

// 2. 節點點擊前:決定是否允許選中、同步隱藏欄位
function beforeClick(treeId, treeNode, clickFlag) {
    // clickFlag: 1=勾選, 2=取消勾選(視設定而定)
    if (clickFlag === 1) { // 選中
        $("#coagencyId").val(treeNode.id);
        $("#parentId").val(treeNode.pId);
        $("#name").val(treeNode.name);
        // 若在 iframe 中同步父頁面
        parent.document.getElementById("coagencyId").value = treeNode.id;
        parent.document.getElementById("parentId").value = treeNode.pId;
        parent.document.getElementById("name").value = treeNode.name;
    } else { // 取消選中
        $("#coagencyId, #parentId, #name").val("");
        parent.document.getElementById("coagencyId").value = "";
        parent.document.getElementById("parentId").value = "";
        parent.document.getElementById("name").value = "";
    }
    return treeNode.click !== false; // 返回 false 可阻止選中
}

// 3. 節點點擊後:觸發詳細資訊顯示
function onClick(event, treeId, treeNode, clickFlag) {
    parent.showCoagencyDetail(); // 假設父頁面有此函數
}

// 4. 異步資料過濾:清理換行符等
function filter(treeId, parentNode, childNodes) {
    if (!childNodes) return null;
    childNodes.forEach(node => {
        node.name = node.name.replace(/\.n/g, '.');
    });
    return childNodes;
}

// 5. 可選:限制異步加載深度
function beforeAsync(treeId, treeNode) {
    return treeNode ? treeNode.level < 5 : true; // 僅展開前 5 層
}

// 6. 初始化
$(document).ready(function() {
    $.fn.zTree.init($("#coagencyTree"), settingOther);
});
</script>

後端回傳資料格式(簡單 JSON)

[
    { "id": 1, "pId": 0, "name": "根節點", "open": true },
    { "id": 11, "pId": 1, "name": "子節點 1" },
    { "id": 12, "pId": 1, "name": "子節點 2" },
    { "id": 111, "pId": 11, "name": "孫節點" }
]

關鍵欄位:id(唯一)、pId(父節點 id,根節點為 0)、name(顯示文字)、open(是否預設展開)。

常見問題與解決

  • 異步不觸發:確認 async.enable: true、url 正確、後端回傳 JSON 格式正確、無跨域攔截。
  • 節點重複:dataFilter 去重、或後端依 id 過濾已載入節點。
  • 大量資料效能:開啟 view: { dblClickExpand: false }、分批載入、虛擬滾動。
  • 複選框:設定 check: { enable: true, chkStyle: "checkbox" },並用 getCheckedNodes() 取值。

現代替代方案

  • Vue/React 生態:vue-treeselect、rc-tree-select。
  • 原生 JS 輕量樹:vanilla-tree、自寫遞迴渲染。
  • 若專案已脫離 jQuery,建議遷移至框架原生元件,減少依賴體積。
copyright © 萬盛學電腦網 all rights reserved