表單提交前,需將使用者在 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; // 供除錯或同步流程使用
}
<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。