萬盛學電腦網

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

後端獲取 zTree 選中節點:getZTreeObj 與 getCheckedNodes 實戰用法

場景說明

表單提交前,需將使用者在 zTree 上勾選的節點 ID 收集並送往後端。本文示範標準流程:透過 $.fn.zTree.getZTreeObj 取得實例,再呼叫 getCheckedNodes(true) 取得勾選節點陣列,最後拼接 ID 字串送出。

完整函式範例

function collectCheckedIds() {
  // 1. 依樹容器 id 取得 zTree 實例
  var zTree = $.fn.zTree.getZTreeObj("classpurview");

  // 2. 取得所有勾選節點(true = 僅回傳勾選,false = 回傳全部含半選)
  var checkedNodes = zTree.getCheckedNodes(true);

  // 3. 萃取 ID 並以逗號分隔
  var ids = [];
  for (var i = 0, len = checkedNodes.length; i < len; i++) {
    ids.push(checkedNodes[i].id);
  }
  var idStr = ids.join(',');

  // 4. 寫入隱藏欄位或直接 AJAX 送出
  $('#hiddenClasspurview').val(idStr);
  // 或 $.post('/api/save', { classpurview: idStr });

  return idStr; // 供除錯或同步流程使用
}

HTML 表單搭配

<form id="permForm" action="/save" method="post">
  <div id="classpurview" class="ztree"></div>
  <input type="hidden" name="classpurview" id="hiddenClasspurview" />
  <button type="button" onclick="collectCheckedIds(); $('#permForm').submit();">儲存權限</button>
</form>

進階:取得完整路徑(父→子)

若後端需完整路徑而非單純 ID,可用 getPath(node) 取得從根到該節點的路徑陣列:

var paths = checkedNodes.map(function(node) {
  var pathNodes = zTree.getPath(node);
  return pathNodes.map(function(n) { return n.name; }).join(' > ');
});
console.log(paths); // ["根節點 > 子分類 > 葉子節點", ...]

常見錯誤與排查

現象可能原因解決方式
getZTreeObj 回傳 null樹容器 id 拼錯、樹未初始化完成確認 id 一致、在 $(document).ready 或 zTreeOnInit 後呼叫
getCheckedNodes 回傳空陣列check.enable 未設 true、chkboxType 設錯setting.check.enable = true; chkboxType: { "Y": "s", "N": "s" }
ID 重複導致後端去重錯誤樹資料本身 id 重複確保資料庫主鍵唯一,或改用唯一鍵(如 code)

小結

getZTreeObj + getCheckedNodes(true) 是後端收集 zTree 勾選資料的標準組合拳,搭配隱藏欄位或 AJAX 即可無縫串接後端 API。

copyright © 萬盛學電腦網 all rights reserved