DIV CSS 佈局教程網

zTree 外掛實作:取得所有被勾選的節點資料
編輯:關於JavaScript     

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 裡就發請求(每勾一下就打一次太吵),而是記狀態、等使用者按「儲存」按鈕時再一次送出。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved