首页 > 代码库 > dtree的使用和扩展

dtree的使用和扩展

相信用过dtree的童靴的不在少数,网络上流传的JS树有很多,例如雪花树MzTreeView,EXT、Struts2出来之后,也有自己的树控件,但是这么多风姿卓约的倩影中,我独爱,独爱dtree那一棵。原因有二:1.简单易用,能满足基本需要 2.代码简单,扩展起来也很容易。 这就像找MM一样,简单单纯傻傻的MM好,那些复杂要猜心的就让她靠边吧,不能把握的再美再好咋都不要,哈哈,扯远了。
言归正传,先介绍dtree的基本使用。第一步,引用dtree的资源,在你的页面文件head标签中引用dtree的js文件和css样式文件。例如我的代码如下,路径视你存放dtree资源的具体情况而定:

<link href="http://www.mamicode.com/css/dtree.css" rel="stylesheet" type="text/css" /> <script src="http://www.mamicode.com/js/dtree.js" type="text/javascript"></script>

第二步,定义和展示树。dtree通常可放在一个div中,在你的页面文件中要显示树的地方,添加下列代码:

<div class="dtree" > <script type="text/javascript">/* 1. 定义一个树对象 */ var d = new dTree(‘d‘); // 隐含创建一个根节点,id等于-1,不可见/* 2. 添加一级节点 */ d.add("0","-1","所有类别"); //这里-1是前面根节点的id,说明是新增的节点是d的直接子节点/* 循环添加其他节点 */ /* 3. 参数说明:1.ID 2.父ID 3.名称 4.URL 5.热点提示 6.URL显示目标target 7.节点关闭时图标 8.节点打开时图标 9.判断节点是否打开 */ <c:forEach items="${userLogSortList}" var="treeNode">d.add( "${treeNode.sortId}","${treeNode.parentId}","${treeNode.sortName}", "${treeNode.url}","${treeNode.sortName}","logList");</c:forEach> /* 4.写的div中展示 */ document.write(d);</script></div> 

对前面代码,简单说明:其中注释里1到3步是对树各节点的定义,注释4是把树最终展示到页面,其中1到3步的代码中用到EL循环和表达式,EL是什么就不要我解释了吧?!如果你不想使用dtree默认的节点关闭和打开的图标,你也可以在add函数的第7个和第8个参数中填上你自己中意的图标路径。

怎么样,很简单吧,当然,树的数据需要你在后台准备好,这对那种树控件都是逃避不了的工作。 但在实际使用中,dtree会有不足,在有些应用场景不能满足我们的需求,所以有必要对dtree进行扩展,这就好比为了爱,我们会不断使自己进步,让自己变得更优秀,尽力把最美好的一面展示给对方,我想dtree如果有灵性,她也希望如此的,呵呵。但是在向完美靠近的过程中,需要根据自身实际情况采取合适的方法,否则适得其反,所以我们有必要先了解dtree,打开你的dtree.js文件吧,让我们感受感受dtree的内心,就像感受和情人之间的心灵默契,有些东西语言是多余的。
dtree.js中最主要有下面几个函数:
1.节点定义函数:function Node(id, pid, name, url, title, target, icon, iconOpen, open)
其中函数中_is属性表示是否被选择,_ls属性表示是否为最后一个兄弟节点,_hc表示是否有子节点,_p指向父节点.

2.树对象定义函数:function dTree(objName) :
该函数完成后述功能:a.定义树全局配置信息 b.定义树默认图标 c.创建树对象和根节点,创建根节点时会调用函数1.

3.节点添加函数:dTree.prototype.add = function(id, pid, name, url, title, target, icon, iconOpen, open) 实际是调用函数1定义节点属性,同时把节点增加到树对象的aNodes节点数组中

4.dTree.prototype.node = function(node, nodeId) 
根据定义构建节点的图标、url(关联展开和关闭函数到非末节点)以及显示文本。

5.dTree.prototype.addNode = function(pNode) 
根据定义构建树首次展示的结构模型,会调用函数4

6.dTree.prototype.toString = function() 
调用函数4、5,串化dtree展示到页面div中。

以上函数1到3在前面代码中定义的步骤时会调用,函数4到5在前面代码中展示树的步骤会调用,这是最重要的几个函数了,
是dtree的思想精华所在了,呵呵,其他的是事件触发函数。学习prototype的童靴也可以用dtree.js作为学习的入门课本,不错的。

了解了dtree的内心,我们再来说说扩展,我这里的第一个需求是为dtree增加checkbox按钮,我想这个是很多童靴都想要的吧,网上已经有很多这样的例子,我也就借花献佛了、抛金引玉了。

步骤1,把函数1头修改为function Node(id, pid, name, url, title, target, icon, iconOpen, open,checked,isBottom) ,在函数体增加下列代码:

this.checked=checked; this.isBottom=isBottom;

 

步骤2,在函数2的函数体的config信息中增加下列代码:

check: false , useAllData: false 

 

其中useAllData这个属性及相关代码可能不是你想要的,但这里我一起给列出来了。

步骤3,函数3的函数体修改后如下:

var node = new Node(id, pid, name, url, title, target, icon, iconOpen, open, checked,isBottom);this.aNodes[this.aNodes.length] = node;var n;var len = this.aNodes.length; if ( node.checked ){ var pid = node.pid; var bSearch; do{ bSearch = false; for( n = 0; n < len; n++){ if ( this.aNodes[n].id == pid){ if (this.aNodes[n].checked == false){this.aNodes[n].checked=true; pid = this.aNodes[n].pid; bSearch= true; break;} } } }while(bSearch==true);}

 


后面两重循环的作用是,当一个节点被勾选时候,改变其父辈祖宗节点的选择状态定义。

步骤4,在函数4中创建图标的代码段中增加下列代码,该代码的作用是用来构建节点checkbox的图标以及为节点关联checkbox勾选触发函数:

if(this.config.check == true){ if(node.checked ==true){ str+= ‘<input type="checkbox" id="c‘+ this.obj + nodeId + ‘" value="http://www.mamicode.com/‘+ node.id +‘" ‘;if (this.config.useAllData) { str+= ‘ name="dataId" ‘; }if (!this.config.useAllData) { str+= node.isBottom ? ‘ name="dataId" ‘:‘ name="nodeId"‘; }str+= ‘ onclick="javascript:‘+this.obj+‘.cc(‘+nodeId+‘)" checked />‘;}else{str+= ‘<input type="checkbox" id="c‘+ this.obj + nodeId + ‘" value="http://www.mamicode.com/‘+ node.id +‘" ‘;if (this.config.useAllData) { str+= ‘ name="dataId" ‘; }if (!this.config.useAllData) { str+= node.isBottom ? ‘ name="dataId" ‘:‘ name="nodeId"‘; }str+= ‘ onclick="javascript:‘+this.obj+‘.cc(‘+nodeId+‘)" />‘;} }

 

步骤5,增加一个新的函数,就是步骤4的cc函数,作用是单节点checkbox勾选状态改变时,改变相应祖宗节点和子孙节点checkbox的状态,如下:

dTree.prototype.cc=function(nodeId){ var cs = document.getElementById("c"+this.obj+nodeId).checked; var n,node = this.aNodes[nodeId]; var len =this.aNodes.length;for (n=0; n<len; n++) {if (this.aNodes[n].pid == node.id) { document.getElementById("c"+this.obj+n).checked=cs; this.cc(n); }}if (cs ==f alse){ var clicknode=node do{for( j=0; j<l en; j++){ if(this.aNodes[j].pid==clicknode.pid&&document.getElementById ("c"+this.obj+j).checked==true){ return; }}if ( j == len) { for(k=0;k<len;k++){ if (this.aNodes[k].id == clicknode.pid ){ document.getElementById("c"+this.obj+k).checked=false; clicknode=this.aNodes[k]; break; } } }}while(clicknode.pid!=-1);}if(cs==true){ var pid=node.pid; var bSearch; do{ bSearch=false; for(n=0;n<len;n++){ if (this.aNodes[n].id == pid ){ document.getElementById("c"+this.obj+n).checked = true; pid = this.aNodes[n].pid; bSearch = true; break; } } }while(bSearch==true);}}

 

稍微麻烦点,但是看到checkbox出来时,我想你会有成就感,就象历尽艰辛情路追到你心仪女孩后时内心的雀跃。

最后讲讲扩展的第二个需求,为末级节点增加外部js函数调用,外部js函数是留给童靴们在使用时去实现的,这样子,童靴们可以在这个外包js函数去定制和树有关的其他业务动作,甚至是异步调用,实现ajax的无刷新效果。具体扩展方法是,在函数4中判断url的代码中再增加一个分支,代码如下:

else if ((!this.config.folderLinks || !node.url) && !node._hc && node.pid != this.root.id){str += ‘<a href="javascript: ‘ + this.obj + ‘treeNodeClick(‘ + node.id + ‘);" class="node">‘;}

 

dtree的使用和扩展