zTree 是國人開發的樹狀外掛,API 文件是中文、範例齊全,因此在需要樹狀結構時是個不錯的選擇。以下示範如何取出所有勾選狀態為 true 的節點。
核心只有一行:treeObj.getCheckedNodes(true)。關鍵在於那個布林參數——傳 true 取「已勾選」的節點,傳 false 則取「未勾選」的。
<!DOCTYPE html>
<HTML>
<HEAD>
<TITLE> ZTREE DEMO - Standard Data </TITLE>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link rel="stylesheet" href="css/zTreeStyle/zTreeStyle.css" type="text/css">
<link rel="stylesheet" href="css/demo.css" type="text/css">
<script type="text/javascript" src="js/jquery-1.4.4.min.js"></script>
<script type="text/javascript" src="js/jquery.ztree.core-3.4.js"></script>
<script type="text/javascript" src="js/jquery.ztree.excheck-3.4.js"></script>
<SCRIPT type="text/javascript">
var setting = {
check: {
enable: true // 必須開啟,否則節點上不會有核取方塊
},
data: {
simpleData: {
enable: true // 使用 id / pId 的簡單資料格式
}
},
callback: {
onCheck: onCheck // 每次勾選狀態變動都會觸發
}
};
var zNodes = [
{ id: 1, pId: 0, name: "隨意勾選 1", open: false },
{ id: 11, pId: 1, name: "隨意勾選 1-1", open: true },
{ id: 111, pId: 11, name: "隨意勾選 1-1-1" },
{ id: 112, pId: 11, name: "隨意勾選 1-1-2" },
{ id: 12, pId: 1, name: "隨意勾選 1-2", open: true },
{ id: 121, pId: 12, name: "隨意勾選 1-2-1" },
{ id: 122, pId: 12, name: "隨意勾選 1-2-2" },
{ id: 2, pId: 0, name: "隨意勾選 2", open: false },
{ id: 21, pId: 2, name: "隨意勾選 2-1" },
{ id: 22, pId: 2, name: "隨意勾選 2-2", open: true },
{ id: 221, pId: 22, name: "隨意勾選 2-2-1" },
{ id: 222, pId: 22, name: "隨意勾選 2-2-2" },
{ id: 23, pId: 2, name: "隨意勾選 2-13" }
];
$(document).ready(function(){
$.fn.zTree.init($("#treeDemo"), setting, zNodes);
});
function onCheck(e, treeId, treeNode){
var treeObj = $.fn.zTree.getZTreeObj("treeDemo");
var nodes = treeObj.getCheckedNodes(true); // true = 只取已勾選的節點
var v = "";
for (var i = 0; i < nodes.length; i++){
v += nodes[i].name + ",";
alert(nodes[i].id); // 取出節點的 id
}
}
</SCRIPT>
</HEAD>
<BODY>
<div class="zTreeDemoBackground left">
<ul id="treeDemo" class="ztree"></ul>
</div>
</BODY>
</HTML>
一定要載入 excheck。只有 core 的話沒有核取方塊,getCheckedNodes 也無從取起。
父子連動的預設行為。zTree 預設開啟父子勾選連動,勾一個父節點會帶著所有子節點一起勾上。若你要的是「各自獨立勾選」,需在 setting 裡設 check.chkboxType = { "Y": "ps", "N": "ps" } 改成不連動。
只想要真正被使用者點過的節點。連動模式下,getCheckedNodes(true) 會把「因為父節點被勾而自動勾上」的子節點也一起回傳。若只要使用者實際點擊的那些,改用 getChangeCheckedNodes() 更精準,效能也更好。
節點上的自訂欄位會保留。回傳的 treeNode 物件除了 name、id、pId 之外,你在初始化資料時塞進去的任何屬性都能讀到,例如 nodes[i].deptCode。
別忘了檢查空陣列。一個都沒勾時 getCheckedNodes(true) 會回傳空陣列,直接取 nodes[0].name 就會報錯。
var nodes = treeObj.getCheckedNodes(true);
if (nodes.length === 0) {
alert("請至少選擇一項。");
return;
}
實務上通常不會在 onCheck 裡就發請求(每勾一下就打一次太吵),而是記狀態、等使用者按「儲存」按鈕時再一次送出。