【简介】
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 举例:
- var setting = {
- showLine: true,
- checkable: true
- };
因为参数太多,具体参数详见zTreeAPI
- 核心参数:zTreeNodes
zTree 的全部节点数据集合,采用由JSON对象组成的数据结构,简单的说:这里使用Json格式保存了树的所有信息
zTreeNodes的格式分为两种:利用Json格式嵌套体现父子关系和Array简单格式
①带有父子关系的标准 zTreeNodes 举例:
- var zTreeNodes = [
- {"id":1, "name":"test1", "nodes":[
- {"id":11, "name":"test11", "nodes":[
- {"id":111, "name":"test111"}
- ]},
- {"id":12, "name":"test12"}
- ]},
- ......
- ];
②带有父子关系的简单 Array 格式(isSimpleData)的 zTreeNodes 举例:
- 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:
- <!-- 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 zTree;
- $(function() {
- zTree = $("#tree").zTree(setting, treeNodes);
- });
④最后查看效果:
【实例二】(从后台获取简单格式Json数据)
①后台代码封装简单格式Json数据:
- 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数据再生成树
- 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:
- 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 //右键事件
- }
- };
②配置鼠标右键事件,显示右键菜单的代码
- //显示右键菜单
- 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);
- }
- }
- }
- <p><span style="background-color: #fafafa;"><!-- 右键菜单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></span></p>
③页面加载时生成树并且监听鼠标点击事件,及时隐藏右键菜单
- 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层-----------------------
- 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层-----------------------
- /**
- * 根据节点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);
- }
⑤最后查看效果:
相关推荐
3. 初始化树:使用jQuery选择器选择容器元素,调用zTree的初始化方法,传入配置参数和数据。 4. 交互处理:绑定事件监听,根据业务需求处理节点的点击、展开等行为。 四、zTree的API及事件 1. API:如`treeObj....
本文将详细介绍jQuery-zTree的核心特性和使用方法。 一、jQuery-zTree概述 jQuery-zTree是一款基于jQuery库的开源项目,其主要功能是构建动态、可交互的树形结构。它不仅支持基本的树形操作,如展开、折叠、选择...
4. 调用zTree方法:使用`$.fn.zTree.init()`方法启动zTree,并传入之前准备好的DOM元素和配置对象。 5. 交互处理:通过zTree提供的API,如`getTreeObj()`、`getSelectedNodes()`等,实现对树节点的动态操作。 四、...
《jQuery-zTree API v2.6详解:打造高效前端树形组件》 在网页开发中,数据的组织和展示方式多种多样,其中树形结构因其层次清晰、逻辑明确的特点,常用于目录管理、组织架构展示等领域。jQuery-zTree是一款基于...
本篇文章将深入探讨jQuery ZTree的核心特性、使用方法以及常见应用场景。 1. **核心特性** - **动态加载**:ZTree支持节点的动态加载,可以根据用户操作或数据变化,实时更新树形结构,提升用户体验。 - **多选...
在`JQuery-zTree-v3.1.rar`这个压缩包中,包含了zTree的最新版本v3.1,提供了完整的源码和文档,方便开发者进行定制和使用。 **二、核心功能** 1. **动态加载**:zTree支持异步加载子节点数据,可以在用户展开父...
3. **初始化配置**:使用 `$.fn.zTree.init()` 方法初始化树,传入容器元素和配置对象。 4. **数据加载**:通过调用 API 的 `setting.treeObj.append()` 方法将 JSON 数据加载到树中。 ### 四、API 介绍 - `...
**jQuery zTree 树形菜单详解** jQuery zTree是一款基于...通过了解其核心功能和使用方法,我们可以轻松地将其融入到项目中,提升用户体验。在实际开发中,可以根据需求对zTree进行更深入的定制,实现更多特色功能。
3. 创建ZTree:将ZTree的节点数据作为JSON对象传递给ZTree初始化方法,配置相应的参数,如显示检查框、是否启用异步加载等。 4. 结合Select2与ZTree:将ZTree的容器作为Select2的下拉菜单,通过监听ZTree的节点点击...
JQuery zTree 是一个基于 jQuery 的插件,用于在网页中构建交互式的树形结构。v3.4 版本是其稳定且功能丰富的版本之一,适用于多种应用场景,如数据展示、导航菜单、文件目录等。它以其易用性、高效性和强大的功能...
4. **初始化zTree**: 使用JavaScript调用zTree的`$.fn.zTree.init()`方法,传入容器元素和JSON数据,初始化树结构。 5. **事件绑定**: 利用zTree的事件机制,可以监听用户的点击、拖拽等行为,进行相应的服务器端...
本文将基于zTreeAPI_v2.5的官方文档,深入探讨其核心功能、参数配置以及常用方法,旨在帮助开发者更好地理解和应用zTree。 #### zTree核心函数 - **zTree(setting,[zTreeNodes])**:这是创建zTree实例的核心函数。...
1. **zTreeAPI.chm**:这是一个帮助文档,提供了zTree的API接口详细说明,包括各个方法、事件和参数的使用指南,是开发和调试zTree时的重要参考资料。 2. **jquery-1.4.2.js**:这是jQuery库的1.4.2版本,zTree依赖...
以上就是zTree基本用法的详细介绍,希望对你理解和使用zTree有所帮助。在实际项目中,你可以根据需求调整配置和数据源,实现更复杂的功能。更多高级特性与详细信息,可参考官方文档或社区资源。
- **初始化ZTree**:在jQuery的$(document).ready()函数中,调用zTree的init方法启动ZTree。例如: ```javascript $(function() { $.fn.zTree.init($("#treeDemo"), setting, zNodes); }); ``` **3. 功能扩展...
在使用jQuery zTree时,我们需要了解以下几个关键知识点: 1. **安装与引入**:首先,需要将JQuery库和zTree的CSS及JS文件引入到HTML页面中。例如,引入JQueryzTreev3.5压缩包中的`zTreeStyle.css`和`jquery.ztree....
zTree通常要求与jQuery兼容,因此在使用zTree时,确保你的项目中已经包含了一个合适的jQuery版本。虽然这里提供的是1.4.2版,但建议使用更新的jQuery版本,如1.7以上,以获取更好的浏览器支持和性能优化。 ### 三、...
这个工具由四个主要文件构成:zTreeStyle.css负责样式定义,jquery-2.1.1.min.js是jQuery库,而jquery.ztree.core.min.js和jquery.ztree.excheck.min.js则是zTree的核心功能和扩展的复选框功能模块。 zTree的主要...
动态加载树 * 【修改】在异步加载模式下,使用 moveNode 方法,且 moveType != "inner" 时,也会导致 targetNode 自动加载子节点的 bug * 【修改】对已经显示的节点(nochecked=true)使用 showNodes 或 showNode 方法...
然后,jQuery ZTree的核心JavaScript文件为`jquery.ztree.core.js`,它包含了ZTree的基本功能,如节点操作、事件处理、数据加载等。在HTML文件中,需要这样引入: ```html <script src="jquery.ztree.core.js"> ```...