Function(parentNode, newNodes, isSilent)zTreeObj.addNodes

概述[ 依赖 jquery.ztree.core 扩展 js ]

添加节点。

v3.x 为了避免原先反复初始化造成的数据重复问题,在 初始化 和 添加节点 时内部进行 clone 操作。如果需要获取数据在 zTree 内的对象,请获取此方法的返回值。

请通过 zTree 对象执行此方法。

Function 参数说明

parentNodeJSON

指定的父节点,如果增加根节点,请设置 parentNode 为 null 即可。

请务必保证此节点数据对象 是 zTree 内部的数据对象

newNodesJSON / Array(JSON)

需要增加的节点数据 JSON 对象集合,数据只需要满足 zTree 的节点数据必需的属性即可,详细请参考“treeNode 节点数据详解”

1、v3.x 支持单独添加一个节点,即如果只新增一个节点,不用必须包在数组中

2、使用简单数据模式,请参考 setting.data.simpleData 内的属性说明

isSilentBoolean

设定增加节点后是否自动展开父节点。

isSilent = true 时,不展开父节点,其他值或缺省状态都自动展开。

返回值Array(JSON)

返回值是 zTree 最终添加的节点数据集合

如果 newNodes 是单个节点数据 JSON,返回值也是将其包在 Array 内

请务必记住:返回值中的数据对象 是 newNodes 被 clone 后的,所以绝对不相等!

function 举例

1. 对于 id = "tree" 的 zTree 增加 1 个根节点

var treeObj = $.fn.zTree.getZTreeObj("tree");
var newNode = {name:"newNode1"};
newNode = treeObj.addNodes(null, newNode);

2. 对于 id = "tree" 的 zTree 增加 3 个根节点

var treeObj = $.fn.zTree.getZTreeObj("tree");
var newNodes = [{name:"newNode1"}, {name:"newNode2"}, {name:"newNode3"}];
newNodes = treeObj.addNodes(null, newNodes);