在使用 zTree 树形元件時,常需「取得某節點及其所有後代節點的 ID,以逗號串接傳給後端」。本文示範官方推薦的 transformToArray 方法,配合簡單迴圈即可高效完成。
/**
* 取得指定節點及其所有子孫節點的 ID 字串(以逗號分隔)
* @param {Object} treeNode - zTree 節點物件
* @returns {String} 如 "101,102,103,104"
*/
function getChildNodes(treeNode) {
// 1. 將節點及其所有後代轉為扁平陣列
var childNodes = ztree.transformToArray(treeNode);
// 2. 萃取 id 欄位
var ids = [];
for (var i = 0, len = childNodes.length; i < len; i++) {
ids.push(childNodes[i].id);
}
// 3. 回傳逗號分隔字串
return ids.join(',');
}
zTreeObj.transformToArray(node):將指定節點及其所有子節點遞迴轉為一維陣列,包含傳入節點本身。id、pId、name、children 等屬性。// 僅取得後代(不含自身)
function getDescendantIds(treeNode) {
var all = ztree.transformToArray(treeNode);
return all.slice(1).map(function(n) { return n.id; }).join(',');
}
// 僅取得葉子節點
function getLeafIds(treeNode) {
var all = ztree.transformToArray(treeNode);
return all.filter(function(n) { return !n.isParent; })
.map(function(n) { return n.id; })
.join(',');
}
transformToArray 內部為遞迴走訪,節點數超過 5,000 時建議改用非遞迴 BFS 實作或分批處理。__allDescendantIds__ 避免重複計算。善用 transformToArray 即可用極少代碼解決「取得子樹所有 ID」的常見需求,搭配 ES5/ES6 陣列方法更能寫出簡潔易維護的程式碼。