树结构控件:jQuery 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代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  1. var setting = {   
  2.     showLine: true,   
  3.     checkable: true   
  4. };   
var setting = { 
    showLine: true, 
    checkable: true 
}; 

 

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

 

核心参数:zTreeNodes

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

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

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

Js代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  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. ];   
var zTreeNodes = [ 
    {"id":1, "name":"test1", "nodes":[ 
      {"id":11, "name":"test11", "nodes":[ 
        {"id":111, "name":"test111"} 
      ]}, 
      {"id":12, "name":"test12"} 
    ]}, 
    ...... 
]; 

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

Js代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  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. ];   
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:

Html代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  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

Java代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  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. ];   
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"}, 
]; 

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

Js代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  1. var zTree;  
var zTree;
Js代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  1. $(function() {  
  2.     zTree = $("#tree").zTree(setting, treeNodes);  
  3.  });  
$(function() {
	zTree = $("#tree").zTree(setting, treeNodes);
 });

 ④最后查看效果:

树结构控件:jQuery zTree

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

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

Java代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  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<String> lstTree = new ArrayList<String>();  
  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数据再生成树

Js代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  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. });  
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);
});

 ③最后显示效果

树结构控件:jQuery zTree

 

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

①配置setting:

Js代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  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.     };  
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   //右键事件
		}
	};

 

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

Js代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  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.     }  
//显示右键菜单
	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);
			}
		}
	}
Js代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  1. <p><span style="background-color: #fafafa;"><!-- 右键菜单div -->  
  2.  <div id="rMenu" style="position:absolute; display:none;">  
  3.  <li>  
  4.  <ul id="m_add" onclick="addPrivilege();"><li>增加</li></ul>  
  5.  <ul id="m_del" onclick="delPrivilege();"><li>删除</li></ul>  
  6.  <ul id="m_del" onclick="editPrivilege();"><li>编辑</li></ul>  
  7.  <ul id="m_del" onclick="queryPrivilege();"><li>查看</li></ul>  
  8.  </li>  
  9.  </div></span></p>  

<!-- 右键菜单div -->  <div id="rMenu" style="position:absolute; display:none;">  <li>  <ul id="m_add" onclick="addPrivilege();"><li>增加</li></ul>  <ul id="m_del" onclick="delPrivilege();"><li>删除</li></ul>  <ul id="m_del" onclick="editPrivilege();"><li>编辑</li></ul>  <ul id="m_del" onclick="queryPrivilege();"><li>查看</li></ul>  </li>  </div>

 ③页面加载时生成树并且监听鼠标点击事件,及时隐藏右键菜单

Js代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  1. function reloadTree() {  
  2.         hideRMenu();  
  3.         zTree = $("#tree").zTree(setting, treeNodes);  
  4.     }     
  5.       
  6.     var zTree;  
  7.     var treeNodes = [];  
  8.       
  9.   
  10. $(function() {  
  11.         reloadTree();  
  12.   
  13.         $("body").bind(//鼠标点击事件不在节点上时隐藏右键菜单  
  14.                 "mousedown",  
  15.                 function(event) {  
  16.                     if (!(event.target.id == "rMenu" || $(event.target)  
  17.                             .parents("#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层-----------------------

Java代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  1. public void doGetPrivilegeTree() throws IOException{  
  2.         String sId = request.getParameter("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.         response.setCharacterEncoding("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层-----------------------

Java代码  树结构控件:jQuery zTree树结构控件:jQuery zTree
  1. /** 
  2.      * 根据节点id,查询其下级节点的数据 
  3.      */  
  4.     @SuppressWarnings("unchecked")  
  5.     @Override  
  6.     public List<Privilege> findPrivilegeTreeById(int treeId) {  
  7.         StringBuffer sbTree= new StringBuffer();  
  8.         sbTree.append("SELECT NEW Privilege(p.id,p.privName,p.description,p.status,p.isLeaf,p.parentId) FROM Privilege p ");  
  9.         sbTree.append("WHERE p.parentId=:treeId ");  
  10.         sbTree.append("AND p.status!=:del ");  
  11.           
  12.         Map<String,Object> mapTree = new HashMap<String, Object>();  
  13.         mapTree.put("treeId", treeId);  
  14.         mapTree.put("del", Privilege.PRIV_STATUS_DELETE);  
  15.           
  16.         return (List<Privilege>) privilegeDao.findByHql(sbTree.toString(), mapTree);  
  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);
	}

 ⑤最后查看效果:
树结构控件:jQuery zTree


API:http://dl2.iteye.com/upload/attachment/0047/5757/4a192c83-78f1-3558-8c06-f889acedbaa2.pdf
上一篇:八皇后问题N种解法(转)


下一篇:数据可视化图表插件--Echarts