zTree的使用方法

【简介】

zTree 是利用 JQuery 的核心代码，实现一套能完成大部分常用功能的 Tree 插件

•  兼容 IE、FireFox、Chrome 等浏览器


•  在一个页面内可同时生成多个 Tree 实例


•  支持 JSON 数据


•  支持一次性静态生成 和 Ajax 异步加载 两种方式


•  支持多种事件响应及反馈


•  支持 Tree 的节点移动、编辑、删除


•  支持任意更换皮肤 / 个性化图标（依靠css）


•  支持极其灵活的 checkbox 或 radio 选择功能


•  简单的参数配置实现 灵活多变的功能

zTree博客地址：http://ztreeapi.iteye.com/

目前zTree作者已经入驻ItEye，如果有什么需要学习的完全可以到作者博客上去学习，而且zTree的版本已经更新了很多次了，下面的内容跟最新版估计会有很大出入，我不能保证下面的教程在最新版可用。zTree真的是非常强大的树组件，希望能对大家有所帮助！

在官网能够下载到zTree的源码、实例和API，其中作者pdf的API写得非常详细（中文的哦）

 【部分函数和属性介绍】

• 核心：zTree(setting, [zTreeNodes])

这个函数接受一个JSON格式的数据对象setting和一个JSON格式的数据对象zTreeNodes，从而建立 Tree。

• 核心参数：setting

zTree 的参数配置都在这里完成，简单的说：树的样式、事件、访问路径等都在这里配置

setting 举例:

Js代码 

1. var setting = {   


2.     showLine: true,   


3.     checkable: true   


4. };   

因为参数太多，具体参数详见zTreeAPI

• 核心参数：zTreeNodes

zTree 的全部节点数据集合，采用由JSON对象组成的数据结构，简单的说：这里使用Json格式保存了树的所有信息

zTreeNodes的格式分为两种：利用Json格式嵌套体现父子关系和Array简单格式

①带有父子关系的标准 zTreeNodes 举例:

Js代码 

1. var zTreeNodes = [   


2.     {"id":1, "name":"test1", "nodes":[   


3.       {"id":11, "name":"test11", "nodes":[   


4.         {"id":111, "name":"test111"}   


5.       ]},   


6.       {"id":12, "name":"test12"}   


7.     ]},   


8.     ......   


9. ];   

②带有父子关系的简单 Array 格式(isSimpleData)的 zTreeNodes 举例：

Js代码 

1. var treeNodes = [                                                                         


2.     {"id":1, "pId":0, "name":"test1"},   


3.     {"id":11, "pId":1, "name":"test11"},   


4.     {"id":12, "pId":1, "name":"test12"},   


5.     {"id":111, "pId":11, "name":"test111"},   


6.     ......   


7. ];   

【实例一】(Java代码)

①在页面引用zTree的js和css：

Html代码 

1.   


2. /Web/common/css/zTreeStyle/zTreeStyle.css" type="text/css">  


3.   


4.   

②在script脚本中定义setting和zTreeNodes

Java代码 

1. var setting = {  


2.         isSimpleData : true,              //数据是否采用简单 Array 格式，默认false  


3.         treeNodeKey : "id",               //在isSimpleData格式下，当前节点id属性  


4.         treeNodeParentKey : "pId",        //在isSimpleData格式下，当前节点的父节点id属性  


5.         showLine : true,                  //是否显示节点间的连线  


6.         checkable : true                  //每个节点上是否显示 CheckBox  


7.     };  


8.   


9. var treeNodes = [   


10.     {"id":1, "pId":0, "name":"test1"},   


11.     {"id":11, "pId":1, "name":"test11"},   


12.     {"id":12, "pId":1, "name":"test12"},   


13.     {"id":111, "pId":11, "name":"test111"},   


14. ];   

 ③在进入页面时生成树结构：

Js代码 

1. var zTree;  

Js代码 

1. $(function() {  


2.     zTree = $("#tree").zTree(setting, treeNodes);  


3.  });  

 ④最后查看效果：

【实例二】(从后台获取简单格式Json数据)

①后台代码封装简单格式Json数据：

Java代码 

1. public void doGetPrivilegeTree() throws IOException{  


2.         String s1 = "{id:1, pId:0, name:\"test1\" , open:true}";  


3.         String s2 = "{id:2, pId:1, name:\"test2\" , open:true}";  


4.         String s3 = "{id:3, pId:1, name:\"test3\" , open:true}";  


5.         String s4 = "{id:4, pId:2, name:\"test4\" , open:true}";  


6.         List lstTree = new ArrayList();  


7.         lstTree.add(s1);  


8.         lstTree.add(s2);  


9.         lstTree.add(s3);  


10.         lstTree.add(s4);  


11.         //利用Json插件将Array转换成Json格式  


12.         response.getWriter().print(JSONArray.fromObject(lstTree).toString());  


13.     }  

②页面使用Ajax获取zTreeNodes数据再生成树

Js代码 

1. var setting = {  


2.     isSimpleData : true,              //数据是否采用简单 Array 格式，默认false  


3.     treeNodeKey : "id",               //在isSimpleData格式下，当前节点id属性  


4.     treeNodeParentKey : "pId",        //在isSimpleData格式下，当前节点的父节点id属性  


5.     showLine : true,                  //是否显示节点间的连线  


6.     checkable : true                  //每个节点上是否显示 CheckBox  


7. };  


8.   


9. var zTree;  


10. var treeNodes;  


11.   


12. $(function(){  


13.     $.ajax({  


14.         async : false,  


15.         cache:false,  


16.         type: 'POST',  


17.         dataType : "json",  


18.         url: root+"/ospm/loginInfo/doGetPrivilegeTree.action",//请求的action路径  


19.         error: function () {//请求失败处理函数  


20.             alert('请求失败');  


21.         },  


22.         success:function(data){ //请求成功后处理函数。    


23.             alert(data);  


24.             treeNodes = data;   //把后台封装好的简单Json格式赋给treeNodes  


25.         }  


26.     });  


27.   


28.     zTree = $("#tree").zTree(setting, treeNodes);  


29. });  

 ③最后显示效果

【实例三】从后台动态获取数据，树节点提供右键菜单功能

①配置setting：

Js代码 

1. var url = "/ospm/loginInfo/doGetPrivilegeTree.action";  


2.     //zTree基本设置  


3.     var setting = {  


4.         async : true, //需要采用异步方式获取子节点数据,默认false  


5.         asyncUrl : root + url, //当 async = true 时，设置异步获取节点的 URL 地址 ,允许接收 function 的引用  


6.         asyncParam : ["id"], //提交的与节点数据相关的必需参数  


7.         isSimpleData : true, //数据是否采用简单 Array 格式，默认false  


8.         treeNodeKey : "id", //在isSimpleData格式下，当前节点id属性  


9.         treeNodeParentKey : "parentId", //在isSimpleData格式下，当前节点的父节点id属性  


10.         nameCol : "privName",            //在isSimpleData格式下，当前节点名称  


11.         expandSpeed : "fast", //设置 zTree节点展开、折叠时的动画速度或取消动画(三种默认定义："slow", "normal", "fast")或 表示动画时长的毫秒数值(如：1000)   


12.         showLine : true, //是否显示节点间的连线  


13.         callback : { //回调函数  


14.             rightClick : zTreeOnRightClick   //右键事件  


15.         }  


16.     };  

②配置鼠标右键事件，显示右键菜单的代码

Js代码 

1. //显示右键菜单  


2.     function showRMenu(type, x, y) {  


3.         $("#rMenu ul").show();  


4.         if (type=="root") {  


5.             $("#m_del").hide();  


6.             $("#m_check").hide();  


7.             $("#m_unCheck").hide();  


8.         }  


9.         $("#rMenu").css({"top":y+"px", "left":x+"px", "display":"block"});  


10.     }  


11.     //隐藏右键菜单  


12.     function hideRMenu() {  


13.         $("#rMenu").hide();  


14.     }  


15.       


16.     //鼠标右键事件-创建右键菜单  


17.     function zTreeOnRightClick(event, treeId, treeNode) {  


18.         if (!treeNode) {  


19.             zTree.cancelSelectedNode();  


20.             showRMenu("root", event.clientX, event.clientY);  


21.         } else if (treeNode && !treeNode.noR) { //noR属性为true表示禁止右键菜单  


22.             if (treeNode.newrole && event.target.tagName != "a" && $(event.target).parents("a").length == 0) {  


23.                 zTree.cancelSelectedNode();  


24.                 showRMenu("root", event.clientX, event.clientY);  


25.             } else {  


26.                 zTree.selectNode(treeNode);  


27.                 showRMenu("node", event.clientX, event.clientY);  


28.             }  


29.         }  


30.     }  

Js代码 

1.   



2.    


3.  
4.   


5.  
6. 增加
  

7.  
8. 删除
  

9.  
10. 编辑
  

11.  
12. 查看
  

13.  
  

14.