openo-portal/portal-common/src/main/webapp/common/thirdparty/zTree/api/cn/zTreeObj.addNodes.html

   1 <div class="apiDetail">\r
   2 <div>\r
   3         <h2><span>Function(parentNode, newNodes, isSilent)</span><span class="path">zTreeObj.</span>addNodes</h2>\r
   4         <h3>概述<span class="h3_info">[ 依赖 <span class="highlight_green">jquery.ztree.core</span> 扩展 js ]</span></h3>\r
   5         <div class="desc">\r
   6                 <p></p>\r
   7                 <div class="longdesc">\r
   8                         <p>添加节点。</p>\r
   9                         <p class="highlight_red">v3.x 为了避免原先反复初始化造成的数据重复问题，在 初始化 和 添加节点 时内部进行 clone 操作。如果需要获取数据在 zTree 内的对象，请获取此方法的返回值。</p>\r
  10                         <p class="highlight_red">请通过 zTree 对象执行此方法。</p>\r
  11                 </div>\r
  12         </div>\r
  13         <h3>Function 参数说明</h3>\r
  14         <div class="desc">\r
  15         <h4><b>parentNode</b><span>JSON</span></h4>\r
  16         <p>指定的父节点，如果增加根节点，请设置 parentNode 为 null 即可。</p>\r
  17         <p class="highlight_red">请务必保证此节点数据对象 是 zTree 内部的数据对象</p>\r
  18         <h4 class="topLine"><b>newNodes</b><span>JSON / Array(JSON)</span></h4>\r
  19         <p>需要增加的节点数据 JSON 对象集合，数据只需要满足 zTree 的节点数据必需的属性即可，详细请参考“treeNode 节点数据详解”</p>\r
  20         <p class="highlight_red">1、v3.x 支持单独添加一个节点，即如果只新增一个节点，不用必须包在数组中</p>\r
  21         <p class="highlight_red">2、使用简单数据模式，请参考 setting.data.simpleData 内的属性说明</p>\r
  22         <h4 class="topLine"><b>isSilent</b><span>Boolean</span></h4>\r
  23         <p>设定增加节点后是否自动展开父节点。</p>\r
  24         <p>isSilent = true 时，不展开父节点，其他值或缺省状态都自动展开。</p>\r
  25         <h4 class="topLine"><b>返回值</b><span>Array(JSON)</span></h4>\r
  26         <p>返回值是 zTree 最终添加的节点数据集合</p>\r
  27         <p class="highlight_red">如果 newNodes 是单个节点数据 JSON，返回值也是将其包在 Array 内</p>\r
  28         <p class="highlight_red">请务必记住：返回值中的数据对象 是 newNodes 被 clone 后的，所以绝对不相等！</p>\r
  29         </div>\r
  30         <h3>function 举例</h3>\r
  31         <h4>1. 对于 id = "tree" 的 zTree 增加 1 个根节点</h4>\r
  32         <pre xmlns=""><code>var treeObj = $.fn.zTree.getZTreeObj("tree");\r
  33 var newNode = {name:"newNode1"};\r
  34 newNode = treeObj.addNodes(null, newNode);\r
  35 </code></pre>\r
  36         <h4>2. 对于 id = "tree" 的 zTree 增加 3 个根节点</h4>\r
  37         <pre xmlns=""><code>var treeObj = $.fn.zTree.getZTreeObj("tree");\r
  38 var newNodes = [{name:"newNode1"}, {name:"newNode2"}, {name:"newNode3"}];\r
  39 newNodes = treeObj.addNodes(null, newNodes);\r
  40 </code></pre>\r
  41 </div>\r
  42 </div>