项目中jquery插件ztree使用记录

Posted 不是一般的菜

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了项目中jquery插件ztree使用记录相关的知识,希望对你有一定的参考价值。

  最近公司要求做一个关于后台的管理系统。在这个mvvm模式横行的年代,虽然这里用jquery做项目可能有点不符合时代的潮流,但是管他呢,能做出来先在说呗(公司以后要改用angular或者vue来统一前端的制作方式),个人觉得jquery还挺好用的。废话这里就不多叙述了。下面就先来一张完成后的图片展示一下ztree可以完成的功能。

 

  额····这边弹出层的阴影是录制软件的问题(这边的前端插件用的是layui,想用的小伙伴可以自行百度layui,顺便一提,我这里用的版本是layui 1.0的,现在layui已经更新到2.0版本了,已经有自适应功能了,挺好用的。你问我为什么不用bootstrap?其实这个项目中UI小伙伴给我的时候插件用的是bootstrap,但是本人就先入为主了,还是觉得layui轻便好用,看个人喜好吧)。

  忘记了初衷这里是来介绍ztree的,好了,下面先来介绍下ztree的基本信息。

  使用ztree的时候可以参考官网的教程来一步步跟着做。zTree官网。详细的api可以参照着官网来看。

  先看ztree的初始化过程:

  

1 zTreeObj = $.fn.zTree.init($obj, setting, nodes);

 

  这是就是初始加载ztree树。第一个参数$obj代表的是你需要加载ztree的容器。一般默认是一个div。第二个参数是我们的配置项。下面会详细介绍,第三个nodes就是我们需要显示的数据,实际项目中一般都是后台返回的json.

  上面展示的功能用到了树的左键点击,邮件点击,拖拽3个大的功能点。这里是我项目中写的setting的内容

 1     var setting = {
 2             callback : {
 3                 onClick : zTreeOnClick,
 4                 onRightClick : zTreeOnRightClick,
 5                 beforeDrag : zTreeBeforeDrag,
 6                 beforeDrop : zTreeBeforeDrop,
 7                 onDrop : zTreeOnDrop,// 如果对象目标不是节点,不会触发beforeDrop,直接触发onDrop
 8             },
 9             data : {
10                 simpleData : {
11                     enable : true,
12                     idKey : "id",
13                     pIdKey : "pId",
14                 },
15                 key : {
16                     name : "sname"
17                 },
18                 keep : {
19                     parent : true,//没有子节点也保持父节点状态
20                     leaf : false
21                 }
22             },
23             edit : {
24                 enable : true,
25                 showRemoveBtn : false,
26                 showRenameBtn : false,
27                 drag : {
28                     isCopy : false,//拖拽节点不是复制
29                     isMove : true,//拖拽节点只是移动
30                     prev : true,//可以放到节点前面
31                     next : true,//可以放到其他节点后面
32                     inner : canInner//能否放到节点里面看回调函数返回的值
33                 }
34             },
35             view : {
36                 selectedMulti : false
37             }
38         };

  这里常用到的左键点击事件什么的这里就不提了,可以参照官网的例子。这里就记录下onRightClick事件和onDrop事件。

  首先是onRightClick事件,弹出右键菜单栏,然后点击不同的节点邮件的菜单栏还是不同的。点击菜单栏上的不同的选项触发不同的事件。首先我们要让右键树节点在相应的地方产生菜单。不过不用急,这里ztree给我们返回的参数中包含了标准的event,右键点击的节点node,还有点击tree的Id(如果一个页面中有多棵树,这个参数就显得十分重要,如果就一个树,那么这个参数就没什么多大的作用)。我们可以通过event来确定鼠标在页面中具体的位置,然后根据node来判断右键菜单的详细内容和相关的绑定事件。下面是项目中的代码:

 1     // 右键菜单功能
 2     function zTreeOnRightClick(event, treeId, treeNode) {
 3         $(\'#rightMenu\').remove();// 移出之前的右键菜单,如果有;
 4         if (treeNode) {
 5             zTreeObj.selectNode(treeNode);
 6             var isEqu = treeNode.isEqu ? true : false, isEquhtml = "";
 7             if (!isEqu) {
 8                 isEquHtml = "<li id=\'addDep\'>添加部门</li>"
 9                         + "<li id=\'addEqu\'>添加设备</li>";
10             }
11             var editName = isEqu ? "修改设备" : "修改部门";
12             var deleteName = isEqu ? "删除设备" : "删除部门";
13             var html = "<ul id=\'rightMenu\'>" + isEquHtml + "<li id=\'edit\'>"
14                     + editName + "</li>" + "<li id=\'delete\'>" + deleteName
15                     + "</li>" + +"</ul>";
16             var menu = $(html).css({
17                 left : event.pageX + 5 + \'px\',
18                 top : event.pageY + 5 + \'px\'
19             });
20             $(\'body\').append(menu);
21             menuClick();// 给添加的元素绑定事件
22         }
23     }

  我这边的实际情况是看树上的节点中是否有isEqu属性。如果含有这个属性则证明是设备节点,那么就只有修改设备和删除设备2个功能。如果没有,那么就证明这个是部门或者公司节点,那么就有添加设备,添加部门,删除设备和删除部门的功能。然后通过jquery的css函数来确定菜单弹出的具体位置。其他的css可以提前在页面中写好,比如说hover事件和菜单的样式。在代码中只要控制菜单的left和top属性就行了。这里值得一提的是,我们给菜单绑定的事件menuClick函数每次都需要在菜单添加的时候运行而不是在$(function(){})中,因为这里的菜单本身是不存在body中的,是右键点击的时候动态生成的,然后点击以后又移除了,所以每次生成的时候都需要给这个菜单绑定相关的点击事件。详细的点击事件这里就不多展开叙述了。

  接下来是拖拽事件。值得一提的是这个beforeDrag和beforeDrop这两个几户一模一样的回调函数,当时没注意被搞懵逼了。beforeDrag是拖拽前调用的,beforeDrop是拖拽结束前调用的回调。其原理就是鼠标的mousedown和mouseup还有一个dragflag(拖拽的标志)。我这里总公司这个节点是不能移动的,所以在beforeDrap回调里面判断一下节点的id,如果是0就代表是总公司,在beforeDrag中返回false就不会再调用onDrag函数了,节点就不能被拖拽。下面是项目中的代码供参考

    function zTreeBeforeDrag(treeId, treeNodes) {
        if (treeNodes[0].id == 0) {
            layer.msg(\'总公司目录无法移动!\', {
                time : 1000
            });
            return false;
        } else {
            return true;
        }
    }

  这里onDrop回调调用后会自动把移动的节点move到你想要移动的地方。但是我这里需要加一个是否移动的提示框,所以如果还是用onDrop的话,会直接移动。因为我这里的弹窗是异步的,js还是会自己执行下去调用onDrop而不管beforeDrop中返回的,除非调用的是系统的comfirm函数,这个会阻塞js进程,但是样式不好调我就放弃了,我这里是直接在onDrop中return掉,不让他移动节点,而是在beforeDrop中自己判断节点是否可以移动,然后调用ztree的moveNode方法自己移动节点。下面是相关代码

 1     // 拖拽子节点判断
 2     function canInner(treeId, treeNodes, targetNode) {
 3         return (targetNode && !targetNode.isEqu);
 4     }
 5     // 拖拽前的判断
 6     function zTreeBeforeDrop(treeId, treeNodes, targetNode, moveType) {
 7         var msg = \'是否将 [\' + treeNodes[0].sname + \'] 移动到 [\' + targetNode.sname;
 8         switch (moveType) {
 9         case \'inner\':
10             msg += \' ]之内?\';
11             break;
12         case \'prev\':
13             msg += \' ]之前?\';
14             break;
15         case \'next\':
16             msg += \' ]之后?\';
17         default:
18             break;
19         }
20         layer.confirm(msg, function(index) {
21             zTreeObj.moveNode(targetNode, treeNodes[0], moveType);
22             layer.close(index);
23         });
24         return false;
25     }
26     // 拖拽结束
27     function zTreeOnDrop(event, treeId, treeNodes, targetNode, moveType)     {
28         if (!targetNode) {
29             layer.msg(\'目标对象无效!\', {
30                 time : 1000
31             });
32             return;
33         }
34     }

  上面代码仅仅用onDrop函数来提示用户移动到的节点是无效的这个功能而已,其他功能都是在beforeDrop中实现的。到这里忘记介绍了nodes这个属性。我们一般会在setting.data中启用simpleData,这样的话我们可以直接设置id和pid2个参数来确定上下级的关系,而不需要嵌套用children这个属性来确定上下级的关系,这样的话后台返回的数据就直接从数据库中取出返回一个List的类型就行而不需要转化成复杂的嵌套模式,这个还是挺好用的。下面是我用到的展示的nodes:

 1     var zNodes = [ {
 2         sname : \'总公司\',
 3         id : 0,
 4         pId : -1,
 5         open : true,
 6         isParent : true
 7     }, {
 8         sname : \'技术中心\',
 9         id : 1,
10         pId : 0,
11         open : true,
12         isParent : true
13     }, {
14         sname : \'生产中心\',
15         id : 2,
16         pId : 0,
17         open : true,
18         isParent : true
19     }, {
20         sname : \'物流中心\',
21         id : 3,
22         pId : 0,
23         open : true,
24         isParent : true
25     }, {
26         sname : \'设备1\',
27         id : 4,
28         pId : 1,
29         isEqu : true,
30 
31     }, {
32         sname : \'设备2\',
33         id : 5,
34         pId : 1,
35         isEqu : true,
36 
37     }, {
38         sname : \'设备3\',
39         id : 6,
40         pId : 2,
41         isEqu : true,
42     }, {
43         sname : \'设备4\',
44         id : 7,
45         pId : 3,
46         isEqu : true,
47     }, ];

  今天这里的记录就差不多到这里了,具体的api还是可以参考官网的。而且官网的教程也很详细,这里就不多介绍了,哈哈(真的不是我懒哦)~

 

以上是关于项目中jquery插件ztree使用记录的主要内容,如果未能解决你的问题,请参考以下文章

ztree学习笔记

JavaScript之jQuery-8 jQuery 使用插件(zTree树插件jQuery UI插件)

jQuery+zTree加载树形结构菜单

jQuery+zTree加载树形结构菜单

JQuery树形插件zTree+iFrame实现个性网址簿工具

zTree使用随笔