Ztree官方API及实例教程

=ZTree v3.x (JQuery Tree插件) 更新日志= <font color="red">为了更好的优化及扩展zTree, 因此决定升级为v3.x，并且对之前的v2.x不兼容，会有很多结构上的修改，对此深感无奈与抱歉，请大家谅解。</font> <font color="red"> 具体修改内容可参考： * [http://www.ztree.me/v3/api.php zTree v3.0 API 文档] * [http://www.ztree.me/v3/demo.php#_101 zTree v3.0 Demo 演示] * [http://www.ztree.me/v3/faq.php#_101 zTree v3.0 常见问题] </font> IE10 ajax Post 无法提交参数的bug http://bugs.jquery.com/ticket/12790 <font color=#041594> *2013.01.28* v3.5.02 * 【增加】setting.check.chkDisabledInherit 属性，用于设置 chkDisabled 在初始化时子节点是否可以继承父节点的 chkDisabled 属性 * 【删除】内部 noSel 方法，使用 selectstart事件 和 "-moz-user-select"样式 处理禁止 节点文字被选择的功能 * 【修改】不兼容 jQuery 1.9 的bug * 【修改】onDrop 的触发规则，保证异步加载模式下，可以在延迟加载结束后触发，避免 onDrop 中被拖拽的节点是已经更新后的数据。 * 【修改】setChkDisabled 方法，增加 inheritParent, inheritChildren 参数设置是否让父子节点继承 disabled * 【修改】异步加载时 拼接参数的方法，由 string 修改为 json 对象 * 【修正】1-2-3 3级节点时，如果 2级节点 全部设置为 nocheck 或 chkDisabled后，勾选3级节点时，1级节点的半勾选状态错误的 bug * 【修改】Demo: checkbox_nocheck.html & checkbox_chkDisabled.html; * 【修改】Demo: edit_super.html，增加 showRenameBtn & showRemoveBtn 的演示 * 【修改】Demo: asyncForAll, 将 post 修改为 get；为了避免由于 IE10 的 bug 造成的客户端 以及 服务端崩溃 IE10 ajax Post 无法提交参数的bug (http://bugs.jquery.com/ticket/12790) *2012.12.21* v3.5.01 * 【优化】clone 方法 * 【修正】对于初始化无 children 属性的父节点进行 reAsyncChildNodes 操作时出错的 bug * 【修正】beforeRename 回调中使用 cancelEditName 方法后，再 return false 导致无法重新进行编辑的 bug * 【修正】exedit 扩展包让 setting.data.key.url 失效的 bug * 【修正】setting.check.autoCheckTrigger 设置为 true 时，onCheck 回调缺少 event 参数的 bug * 【修正】singlepath.html Demo 中的 bug *2012.11.20* v3.5 * 【优化】原先的 clone 方法 （特别感谢：愚人码头） * 【修改】隐藏父节点后，使用 expandAll 方法导致 父节点展开的 bug * 【修改】使用 jQuery v1.7 以上时，设置 zTree 容器 ul 隐藏（visibility: hidden;）后， 调用 selectNode 导致 IE 浏览器报错 Can't move focus 的 bug * 【修改】正在异步加载时，执行 destory 或 init 方法后，异步加载的节点影响新树的 bug * 【修改】方法 reAsyncChildNodes 在 refresh 的时候未清空内部 cache 导致内存泄露 的 bug * 【修改】批量节点拖拽到其他父节点内（inner）时，导致顺序反转 的 bug * 【修改】对于 使用 html格式的 节点无法触发 双击事件 的 bug * 【修改】onCheck 回调中的 event ，保证与触发事件中的 event 一致 * 【修改】异步加载时，在 onNodeCreated 中执行 selectNode 后，导致节点折叠的 bug * 【修改】API 中 dataFilter 的参数名称 childNodes -> responseData * 【修改】API 中 iconSkin 的 举例内容 * 【修改】API 中 chkDisabled 的说明 * 【修改】Demo 中 index.html 内的 loadReady 重复绑定问题 *2012.09.03* v3.4 * 【增加】 Demo —— OutLook 样式的左侧菜单 * 【增加】清空 zTree 的方法 $.fn.zTree.destory(treeId) & zTree.destory() * 【修改】core核心文件内 _eventProxy 方法中获取 tId 的方法，提高 DOM 的灵活性 * 【修改】初始化时 多层父节点的 checkbox 半选状态计算错误的 bug * 【修改】同时选中父、子节点后，利用 getSelectedNodes 获取选中节点并利用 removeNode 删除时报错的 bug * 【修改】treeNode.chkDisabled / nocheck 属性，支持字符串格式的 "false"/"true" * 【修改】异步加载模式下无法利用 server 返回 xml 并且 在 dataFilter 中继续处理的 bug * 【修改】title 只允许设置为 string 类型值的问题。 修正后允许设置为 number 类型的值 * 【修改】zId 计数规则 & Cache 保存，减少 IE9 的 bug 造成的内存泄漏 * 【修改】API 页面搜索功能导致 IE 崩溃的 bug *2012.07.16* v3.3 * 【增加】扩展库 exhide -- 节点隐藏功能 * 【修改】getNodesByFilter 方法，添加 invokeParam 自定义参数 * 【修改】拖拽中测试代码未删除，导致出现黄颜色的 iframe 遮罩层的 bug * 【修改】延迟加载方法 对于使用 expandAll 进行全部展开时，导致 onNodeCreated 回调 和 addDiyDom 方法触发过早的 bug * 【修改】使用 moveNode 移动尚未生成 DOM 的节点时，视图会出现异常的 bug * 【修改】删除节点后，相关节点的 isFirstNode 属性未重置的 bug * 【修改】getPreNode(),getNextNode() 方法在对于特殊情况时计算错误的 bug * 【修改】设置 title 之后，如果重新将 title 内容设置为空后，会导致无法更新 title 的 bug * 【修改】针对 setting.check.chkStyle=="radio" && setting.check.radioType=="all" 的情况时，getTreeCheckedNodes方法优化，找到一个结果就 break * 【修改】zTreeObj.getCheckedNodes(false) 在 radioType = "all" 时计算错误的 bug * 【修改】完善 API 中 beforeDrop / onDrop 的关于 treeId 的说明 *2012.05.13* v3.2 * 【增加】setting.data.key.url 允许修改 treeNode.url 属性 * 【增加】getNodesByFilter(filter, isSingle) 方法 * 【增加】"与其他 DOM 拖拽互动" 的 Demo (http://www.baby666.cn/v3/demo.php#_511) * 【增加】"异步加载模式下全部展开" 的 Demo (http://www.baby666.cn/v3/demo.php#_512) * 【修改】代码结构，将 addNodes、removeNode、removeChildNodes 方法 和 beforeRemove、onRemove 回调 转移到 core 内 * 【修改】IE7的环境下无子节点的父节点反复展开出现多余空行的 bug * 【修改】异步加载时，如果出现网络异常等，会导致 图标显示错误的 bug * 【修改】dataFilter中 return null 导致异常 的 bug * 【修改】removeChildNodes 方法清空子节点后，无法正常添加节点的 bug * 【修改】moveNode 后节点中的自定义元素的事件丢失的 bug * 【修改】moveNode 方法中设置 isSilent = true 时，如果移动到已展开的 父节点后，出现异常的 bug * 【修改】onClick/onDrag/onDrop 回调中 event 不是原始 event 的 bug * 【修改】onDrop 回调中 当拖拽无效时，无法获得 treeNodes 的 bug * 【修改】onDrop 无法判断拖拽是 移动还是复制的问题 * 【修改】未开启异步加载模式时，拖拽节点到子节点为空的父节点内时 出现异常 的 bug * 【修改】拖拽过程中，反复在 父节点图标上划动时，会出现停顿的 bug * 【修改】拖拽操作时箭头 与 targetNode 背景之间的细节现实问题，便于用户拖拽时更容易区分 prev、next 和 inner 操作 * 【修改】拖拽操作时IE6/7 下 在 节点<a> 右侧 10px 内会导致 targetNode = root 的 bug * 【修改】编辑模式下 默认的编辑按钮、删除按钮点击后，如果相应的 before 回调 return false 时会触发 onClick 回调的 bug *2012.02.14* v3.1 * 【增加】ajax 的参数 setting.async.contentType ，让提交参数适用于 json 数据提交 （主要适用于 .Net 的开发）。 * 【增加】settin