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>
[
{ "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() 取值。