zTree 是一款功能強大的 jQuery 樹狀選單插件,支援核心樹結構、複選框、編輯、拖拽等擴展。本文以實際專案需求為例,詳細說明如何引入 zTree、配置設定、實現「滑鼠懸停顯示全選按鈕」與「點擊節點自動填入收件人框」等進階互動。
至少需載入核心 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">
zTree 透過 setting 物件配置行為。以下範例啟用滑鼠懸停自定義按鈕(addHoverDom、removeHoverDom)與點擊回調(beforeClick、onClick):
var setting = {
view: {
addHoverDom: addHoverDom,
removeHoverDom: removeHoverDom
},
callback: {
beforeClick: beforeClick,
onClick: onClick
}
};
beforeClick:點擊前觸發,可在此攔截或修改資料。範例中檢查收件人框是否已包含該節點資訊,若無則追加「名稱<電話>」格式字串。onClick:點擊後觸發,若 beforeClick 回傳 false 則不會執行。僅對一級目錄(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();
}
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" }
]
}
];
$(document).ready(function(){
$.fn.zTree.init($("#treeDemo"), setting, zNodes);
});
zTree 透過模組化設計,讓開發者能按需載入功能,並提供豐富的回調與事件機制,極適合構建複雜的樹狀介面。本文示範的「懸停全選」與「點擊收集資料」模式,可直接套用於通訊錄選擇、權限樹勾選等實務場景。