【简介】
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 举例:
1. var
2. true,
3. true
4. };
var setting = {
showLine: true,
checkable: true
};
因为参数太多，具体参数详见zTreeAPI
• 核心参数：zTreeNodes zTree 的全部节点数据集合，采用由JSON对象组成的数据结构，简单的说：这里使用Json格式保存了树的所有信息
zTreeNodes的格式分为两种：利用Json格式嵌套体现父子关系和Array简单格式
①带有父子关系的标准 zTreeNodes 举例:
1. var
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. ];
var zTreeNodes = [
{"id":1, "name":"test1", "nodes":[
{"id":11, "name":"test11", "nodes":[
{"id":111, "name":"test111"}
]},
{"id":12, "name":"test12"}
]},
......
];
②带有父子关系的简单 Array 格式(isSimpleData)的 zTreeNodes 举例：
1. var
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. ];
var treeNodes = [ {"id":1, "pId":0, "name":"test1"},
{"id":11, "pId":1, "name":"test11"},
{"id":12, "pId":1, "name":"test12"},
{"id":111, "pId":11, "name":"test111"},
......
];
【实例一】(Java代码)
①在页面引用zTree的js和css：
1. <!-- ZTree树形插件 -->
2. <link rel="stylesheet" href="<%=root%>/Web/common/css/zTreeStyle/zTreeStyle.css" type="text/css">
3. <!-- <link rel="stylesheet" href="<%=root%>/Web/common/css/zTreeStyle/zTreeIcons.css" type="text/css"> -->
4. <script type="text/javascript" src="<%=root%>/Web/common/js/jquery-ztree-2.5.min.js"></script><!-- ZTree树形插件 -->
<link rel="stylesheet" href="<%=root%>/Web/common/css/zTreeStyle/zTreeStyle.css" type="text/css">
<!-- <link rel="stylesheet" href="<%=root%>/Web/common/css/zTreeStyle/zTreeIcons.css" type="text/css"> -->
<script type="text/javascript" src="<%=root%>/Web/common/js/jquery-ztree-2.5.min.js"></script>②在script脚本中定义setting和zTreeNodes
var setting = {
isSimpleData : true, //数据是否采用简单 Array 格式，默认false
treeNodeKey : "id", //在isSimpleData格式下，当前节点id属性
treeNodeParentKey : "pId", //在isSimpleData格式下，当前节点的父节点id属性
showLine : true, //是否显示节点间的连线
checkable : true //每个节点上是否显示 CheckBox
};
var treeNodes = [
{"id":1, "pId":0, "name":"test1"},
{"id":11, "pId":1, "name":"test11"},
{"id":12, "pId":1, "name":"test12"},
{"id":111, "pId":11, "name":"test111"},
];var setting = {
isSimpleData : true, //数据是否采用简单 Array 格式，默认false
treeNodeKey : "id", //在isSimpleData格式下，当前节点id属性
treeNodeParentKey : "pId", //在isSimpleData格式下，当前节点的父节点id属性
showLine : true, //是否显示节点间的连线
checkable : true //每个节点上是否显示 CheckBox
};
var treeNodes = [
{"id":1, "pId":0, "name":"test1"},
{"id":11, "pId":1, "name":"test11"},
{"id":12, "pId":1, "name":"test12"},
{"id":111, "pId":11, "name":"test111"},
];1. var setting = {
2. true, //数据是否采用简单 Array 格式，默认false
3. "id", //在isSimpleData格式下，当前节点id属性
4. "pId", //在isSimpleData格式下，当前节点的父节点id属性
5. true, //是否显示节点间的连线
6. 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. ];③在进入页面时生成树结构：
1. var
var zTree;
1. $(function() {
2. "#tree").zTree(setting, treeNodes);
3. });
$(function() { zTree = $("#tree").zTree(setting, treeNodes); });④最后查看效果：
【实例二】(从后台获取简单格式Json数据)
①后台代码封装简单格式Json数据：
1. public void doGetPrivilegeTree() throws
2. "{id:1, pId:0, name:\"test1\" , open:true}";
3. "{id:2, pId:1, name:\"test2\" , open:true}";
4. "{id:3, pId:1, name:\"test3\" , open:true}";
5. "{id:4, pId:2, name:\"test4\" , open:true}";
6. new
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. }public void doGetPrivilegeTree() throws IOException{
String s1 = "{id:1, pId:0, name:\"test1\" , open:true}";
String s2 = "{id:2, pId:1, name:\"test2\" , open:true}";
String s3 = "{id:3, pId:1, name:\"test3\" , open:true}";
String s4 = "{id:4, pId:2, name:\"test4\" , open:true}";
List<String> lstTree = new ArrayList<String>();
lstTree.add(s1);
lstTree.add(s2);
lstTree.add(s3);
lstTree.add(s4);
//利用Json插件将Array转换成Json格式
response.getWriter().print(JSONArray.fromObject(lstTree).toString());
}②页面使用Ajax获取zTreeNodes数据再生成树
1. var
2. true, //数据是否采用简单 Array 格式，默认false
3. "id", //在isSimpleData格式下，当前节点id属性
4. "pId", //在isSimpleData格式下，当前节点的父节点id属性
5. true, //是否显示节点间的连线
6. true //每个节点上是否显示 CheckBox
7. };
8.
9. var
10. var
11.
12. $(function(){
13. $.ajax({
14. false,
15. false,
16. 'POST',
17. "json",
18. "/ospm/loginInfo/doGetPrivilegeTree.action",//请求的action路径
19. function () {//请求失败处理函数
20. '请求失败');
21. },
22. function(data){ //请求成功后处理函数。
23. alert(data);
24. //把后台封装好的简单Json格式赋给treeNodes
25. }
26. });
27.
28. "#tree").zTree(setting, treeNodes);
29. });
var setting = { isSimpleData : true, //数据是否采用简单 Array 格式，默认false treeNodeKey : "id", //在isSimpleData格式下，当前节点id属性 treeNodeParentKey : "pId", //在isSimpleData格式下，当前节点的父节点id属性 showLine : true, //是否显示节点间的连线 checkable : true //每个节点上是否显示 CheckBox};var zTree;
var treeNodes;
$(function(){
$.ajax({
async : false,
cache:false,
type: 'POST',
dataType : "json",
url: root+"/ospm/loginInfo/doGetPrivilegeTree.action",//请求的action路径
error: function () {//请求失败处理函数
alert('请求失败');
},
success:function(data){ //请求成功后处理函数。
alert(data);
treeNodes = data; //把后台封装好的简单Json格式赋给treeNodes
}
});
zTree = $("#tree").zTree(setting, treeNodes);
});
③最后显示效果
【实例三】从后台动态获取数据，树节点提供右键菜单功能
①配置setting：
1. var url = "/ospm/loginInfo/doGetPrivilegeTree.action";
2. //zTree基本设置
3. var
4. true, //需要采用异步方式获取子节点数据,默认false
5. //当 async = true 时，设置异步获取节点的 URL 地址 ,允许接收 function 的引用
6. "id"], //提交的与节点数据相关的必需参数
7. true, //数据是否采用简单 Array 格式，默认false
8. "id", //在isSimpleData格式下，当前节点id属性
9. "parentId", //在isSimpleData格式下，当前节点的父节点id属性
10. "privName", //在isSimpleData格式下，当前节点名称
11. "fast", //设置 zTree节点展开、折叠时的动画速度或取消动画(三种默认定义："slow", "normal", "fast")或 表示动画时长的毫秒数值(如：1000)
12. true, //是否显示节点间的连线
13. //回调函数
14. //右键事件
15. }
16. };
var url = "/ospm/loginInfo/doGetPrivilegeTree.action"; //zTree基本设置 var setting = { async : true, //需要采用异步方式获取子节点数据,默认false asyncUrl : root + url, //当 async = true 时，设置异步获取节点的 URL 地址 ,允许接收 function 的引用 asyncParam : ["id"], //提交的与节点数据相关的必需参数 isSimpleData : true, //数据是否采用简单 Array 格式，默认false treeNodeKey : "id", //在isSimpleData格式下，当前节点id属性 treeNodeParentKey : "parentId", //在isSimpleData格式下，当前节点的父节点id属性
nameCol : "privName", //在isSimpleData格式下，当前节点名称
expandSpeed : "fast", //设置 zTree节点展开、折叠时的动画速度或取消动画(三种默认定义："slow", "normal", "fast")或 表示动画时长的毫秒数值(如：1000)
showLine : true, //是否显示节点间的连线
callback : { //回调函数
rightClick : zTreeOnRightClick //右键事件
}
};
②配置鼠标右键事件，显示右键菜单的代码
1. //显示右键菜单
2. function
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
13. "#rMenu").hide();
14. }
15.
16. //鼠标右键事件-创建右键菜单
17. function
18. if
19. zTree.cancelSelectedNode();
20. "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. "root", event.clientX, event.clientY);
25. else
26. zTree.selectNode(treeNode);
27. "node", event.clientX, event.clientY);
28. }
29. }
30. }
//显示右键菜单 function showRMenu(type, x, y) { $("#rMenu ul").show(); if (type=="root") { $("#m_del").hide(); $("#m_check").hide(); $("#m_unCheck").hide(); } $("#rMenu").css({"top":y+"px", "left":x+"px", "display":"block"}); }
//隐藏右键菜单
function hideRMenu() {
$("#rMenu").hide();
}
//鼠标右键事件-创建右键菜单
function zTreeOnRightClick(event, treeId, treeNode) {
if (!treeNode) {
zTree.cancelSelectedNode();
showRMenu("root", event.clientX, event.clientY);
} else if (treeNode && !treeNode.noR) { //noR属性为true表示禁止右键菜单
if (treeNode.newrole && event.target.tagName != "a" && $(event.target).parents("a").length == 0) {
zTree.cancelSelectedNode();
showRMenu("root", event.clientX, event.clientY);
} else {
zTree.selectNode(treeNode);
showRMenu("node", event.clientX, event.clientY);
}
}
}
1. <p><span style="background-color: #fafafa;"><!-- 右键菜单div -->
2. "rMenu" style="position:absolute; display:none;">
3. <li>
4. "m_add" οnclick="addPrivilege();"><li>增加</li></ul>
5. "m_del" οnclick="delPrivilege();"><li>删除</li></ul>
6. "m_del" οnclick="editPrivilege();"><li>编辑</li></ul>
7. "m_del" οnclick="queryPrivilege();"><li>查看</li></ul>
8. </li>
9. </div></span></p>
<!-- 右键菜单div --> <div id="rMenu" style="position:absolute; display:none;"> <li> <ul id="m_add" οnclick="addPrivilege();"><li>增加</li></ul> <ul id="m_del" οnclick="delPrivilege();"><li>删除</li></ul> <ul id="m_del" οnclick="editPrivilege();"><li>编辑</li></ul> <ul id="m_del" οnclick="queryPrivilege();"><li>查看</li></ul> </li> </div>
③页面加载时生成树并且监听鼠标点击事件，及时隐藏右键菜单
1. function
2. hideRMenu();
3. "#tree").zTree(setting, treeNodes);
4. }
5.
6. var
7. var
8.
9.
10. $(function() {
11. reloadTree();
12.
13. "body").bind(//鼠标点击事件不在节点上时隐藏右键菜单
14. "mousedown",
15. function(event) {
16. if (!(event.target.id == "rMenu"
17. "#rMenu").length > 0)) {
18. "#rMenu").hide();
19. }
20. });
21. });
function reloadTree() { hideRMenu(); zTree = $("#tree").zTree(setting, treeNodes); } var zTree; var treeNodes = []; $(function() { reloadTree(); $("body").bind(//鼠标点击事件不在节点上时隐藏右键菜单 "mousedown",
function(event) {
if (!(event.target.id == "rMenu" || $(event.target)
.parents("#rMenu").length > 0)) {
$("#rMenu").hide();
}
});
});④后台代码根据id获取树节点信息
-----------------------Action层-----------------------
1. public void doGetPrivilegeTree() throws
2. "id");
3. int treeId = 0;
4. if(sId!=null&&!"".equals(sId)){
5. treeId = Integer.parseInt(sId);
6. }
7. List<Privilege> lstPriv = privilegeService.findPrivilegeTreeById(treeId);
8. "UTF-8");
9. response.getWriter().print(JSONArray.fromObject(lstPriv).toString());
10. }public void doGetPrivilegeTree() throws IOException{
String sId = request.getParameter("id");
int treeId = 0;
if(sId!=null&&!"".equals(sId)){
treeId = Integer.parseInt(sId);
}
List<Privilege> lstPriv = privilegeService.findPrivilegeTreeById(treeId);
response.setCharacterEncoding("UTF-8");
response.getWriter().print(JSONArray.fromObject(lstPriv).toString());
}-----------------------Service层-----------------------
1. /**
2. * 根据节点id，查询其下级节点的数据
3. */
4. @SuppressWarnings("unchecked")
5. @Override
6. public List<Privilege> findPrivilegeTreeById(int
7. new
8. "SELECT NEW Privilege(p.id,p.privName,p.description,p.status,p.isLeaf,p.parentId) FROM Privilege p ");
9. "WHERE p.parentId=:treeId ");
10. "AND p.status!=:del ");
11.
12. new
13. "treeId", treeId);
14. "del", Privilege.PRIV_STATUS_DELETE);
15.
16. return
17. }/**
* 根据节点id，查询其下级节点的数据
*/
@SuppressWarnings("unchecked")
@Override
public List<Privilege> findPrivilegeTreeById(int treeId) {
StringBuffer sbTree= new StringBuffer();
sbTree.append("SELECT NEW Privilege(p.id,p.privName,p.description,p.status,p.isLeaf,p.parentId) FROM Privilege p ");
sbTree.append("WHERE p.parentId=:treeId ");
sbTree.append("AND p.status!=:del ");
Map<String,Object> mapTree = new HashMap<String, Object>();
mapTree.put("treeId", treeId);
mapTree.put("del", Privilege.PRIV_STATUS_DELETE);
return (List<Privilege>) privilegeDao.findByHql(sbTree.toString(), mapTree);
} ⑤最后查看效果：
API:http://dl2.iteye.com/upload/attachment/0047/5757/4a192c83-78f1-3558-8c06-f889acedbaa2.pdf
本文章为转载内容，我们尊重原作者对文章享有的著作权。如有内容错误或侵权问题，欢迎原作者联系我们进行内容更正或删除文章。
