在应用程序中,我们经常需要显示或处理树状结构的对象信息,比如部门信息和地区信息,树是一种非常典型的数据结构,这些信息都可以用树来表示。对于传统的HTML页面来说,完全依靠手动编码来实现树是比较困难的,因为需要写很多的JS代码,对基于AJAX异步加载来说尤其如此,不但涉及AJAX数据异步加载,还需要考虑跨浏览器支持,处理起来非常麻烦,EXT中提供了现成的树控件,通过这些控件,可以在B/S应用中快速开发出包含树形信息结构的应用。
本文就是详细介绍树形结构的使用过程和实例。
一、创建一棵树
树控件由Ext.tree.TreePanel类定义,控件的名称为TreePanel,TreePanel类继承自Panel面板,在EXT中使用树控件非常简单,我们先来看一下代码(包含配置信息)。
?
- <html?xmlns="http://www.w3.org/1999/xhtml"?>??
- <head?id="Head1"?runat="server">??
- ????<title>简单的树形</title>??
- ????<link?rel="stylesheet"?type="text/css"?href="../resources/css/ext-all.css"/>??
- ????<script?type="text/javascript"?src="../adapter/ext/ext-base.js"</script>??
- ????<script?type="text/javascript"?src="../ext-all.js"></script>??
- ????<script?type="text/javascript"><!--??
- ????????Ext.onReady(function(){??
- ????????????var?tree=new?Ext.tree.TreePanel({??
- ????????????????el:'tree'??
- ????????????});??
- ????????????var?root=new?Ext.tree.TreeNode({text:'我是根'});??
- ????????????tree.setRootNode(root);??
- ????????????tree.render();??????????????
- ????????});??????
- </script>??
- </head>??
- <body>??
- ?<div?id="tree"></div>??
- </body>??
- </html>??
?
这里的参数tree表示渲染的DOM的id.HTML中应该要要有<div id="tree"></div>相对应,最后这棵树就出现在这个div的位置上。
在获得了树形面板后,就必须要设置根,因为必须有了根才可以生长枝节,最后生成完整的树,所以根是必须的。具体实现的效果如图1所示。
图1 只有根的树
二、为树生枝展叶
上面的实例代码生成一棵没有根的树,下面的代码就为树添加枝和叶,代码清单如下:
?
- <script?type="text/javascript">??
- ????????Ext.onReady(function(){??
- ????????????var?tree=new?Ext.tree.TreePanel({??
- ????????????????el:'tree',??
- ????????????????autoHeight:true??
- ????????????});??
- ????????????var?root=new?Ext.tree.TreeNode({text:'区域信息'});??????????????
- ????????????var?node1=new?Ext.tree.TreeNode({text:'湖南省'});??
- ????????????var?node3=new?Ext.tree.TreeNode({text:'广东省'});??
- ????????????var?node2=new?Ext.tree.TreeNode({text:'广州市'});????
- ??????????????????????
- ????????????node3.appendChild(node2);??
- ????????????root.appendChild(node1);??
- ????????????root.appendChild(node3);???
- ????????????tree.setRootNode(root);????
- ????????????????????????
- ????????????tree.render();??????????????
- ????????});??
- ?</script>??
?
效果图如图2所示:
图2 完整的树控件
注意:我们一方面可以通过修改<div id="tree" style="height:300px;"></div>来设置div高度;同时也可以设置treePanel的 autoHeight属性为tree,则可以自动计算高度,否则展开的树形控件看不到枝叶。
三、使用TreeLoader获得数据
使用上面的录入方式来获取数据不仅麻烦,而且还容易出错,Ext.tree.TreeLoader可以利用从后台获取的数据为我们组装出一棵树来,我们只需要提供数据,让treeLoader完成数据转换和装配节点的操作。
(1)我们要为TreePanel配置一个TreeLoader,如下面代码所示:
?
- var?tree=new?Ext.tree.TreePanel({??
- ????????????????el:'tree',??
- ????????????????loader:new?Ext.tree.TreeLoader({dataUrl:'data.txt'}),??????????????????
- ????????????????autoHeight:true??
- ????????????});??
?
(2)这里的TreeLoader仅包含一个参数{dataUrl:'data.txt'},这个dataUrl表示在树完成渲染后从何处读取数据。data.txt内容如下:
?
- [??
- ????{text:'not?leaf'},??
- ????{text:'is?leaf',leaf:true}??
- ]??
?
(3) 现在查看页面依然只能看到根,没有读取数据并显示到页面上,因为我们使用的TreeNode不支持Ajax,我们需要将其改成 AsyncTreeNode,这样才可以实现我们想要的异步加载效果,如下面的代码所示:
?
- var?root=new?Ext.tree.AsyncTreeNode({text:'区域信息'});??
?
注意:必须将root.expand(true,true)修改成root.expand()避免无限循环展开树枝。
四、读取本地JSON数据
读取本地JSON其实是一种是用使用TreeLoader的另类方法。因为有时候树形的数据并不多,为了获取少量的数据而是用AJAX访问后台实在不划算。首先为TreePanel设置一个参数为空的TreeLoader,如下面代码所示:
?
- var?tree=new?Ext.tree.TreePanel({??
- ????????????????el:'tree',??
- ????????????????loader:new?Ext.tree.TreeLoader(),??????????????????
- ????????????????autoHeight:true??
- ????????????});??
?
然后,设置一个根节点,并为这个根节点设置children属性,如下面代码所示:
?
- var?root=new?Ext.tree.AsyncTreeNode({??
- ????????????????text:'我是根',??
- ????????????????children:[??
- ????????????????????{text:'Leaf?No.1',leaf:true},??
- ????????????????????{text:'Leaf?No.1',leaf:true}??
- ????????????????]??
- ????????????});??
- ????????????tree.setRootNode(root);???
?
这里需要注意几点:
(1) 必须设置TreeLoader,否则根节点会一直处于在读取状态,无法获得children中定义的子节点
(2) 根节点必须是AsyncTreeNode,如果是TreeNode,也无法生成子节点
(3) 子节点中的叶子节点必须都加上leaf:true,否则会一直显示读取状态。
五、右键菜单
树形弹出的右键菜单效果图如图3所示:
图3 右键菜单效果
具体实现步骤如下:
(1) 制作自定义菜单,如下面的代码所示:
?
- var?contextmenu=new?Ext.menu.Menu({??
- ????????????????id:'theContextMenu',??
- ????????????????????items:[{??
- ????????????????????????text:'点击',??
- ????????????????????????handler:function(){??
- ????????????????????????????alert(' 我被点中了');??
- ????????????????????????}??
- ????????????????????}]??
- ????????????});??
?
(2) 绑定contextmenu时间,如下面代码所示:
?
- tree.on("contextmenu",function(node,e){??
- ????????????????e.preventDefault();??
- ????????????????node.select();??
- ????????????????contextmenu.showAt(e.getXY());??
- ????????????});??
?
六、修改节点的默认图标
实际上,每个树形节点都有icon和iconCls属性,他们负责制定节点的图标,现在我们来修改树种节点的图标,无论是通过new手工创建的节点,还是通过JSON读取到的节点,设置方式都是一样,如下面代码所示:
?
- var?root1=new?Ext.tree.TreeNode({??
- ????????????????text:'icon',??
- ????????????????icon:'user_female.png'??
- ????????????});??
?
七、从节点弹出对话框
下面的代码可以让对话框看起来像是从标题上飞出来的:
?
- tree.on("click",function(node){??
- ????????????????Ext.Msg.show({??
- ????????????????????title:'提示',??
- ????????????????????msg:"你单击了"+node,??
- ????????????????????animEl:node.ui.textNode??
- ????????????????});??
- ????????????});??
?
八、节点提示信息
当我们把鼠标停留在某个节点的上方时,便会出现提示信息,为了实现这种效果,我们需要对提供的JSON数据做一些修改,在JSON中添加对应的节点提示信息,我们给每个节点数据都加上qtip:'xxx'参数,这个节点就可以显示提示信息了。
不过,仅仅为JSON添加这个参数还不能在页面上显示提示信息,需要先在JS中对EXT的提示功能进行初始化。
?
- Ext.QuickTips.init();//开启提示功能??
?
上面这行代码必须在其他功能加载前完成,建议写在onReady函数的第一行。具体代码如下:
?
- <script?type="text/javascript">??
- ????????Ext.onReady(function(){??
- ????????????Ext.QuickTips.init();??
- ????????????var?tree=new?Ext.tree.TreePanel({??
- ????????????????el:'tree',??
- ????????????????loader:new?Ext.tree.TreeLoader(),??????????????????
- ????????????????autoHeight:true??
- ????????????});??
- ????????????var?root=new?Ext.tree.AsyncTreeNode({??
- ????????????????text:'我是根',??
- ????????????????children:[??
- ????????????????????{text:'Leaf?No.1',qtip:'No1',leaf:true},??
- ????????????????????{text:'Leaf?No.1',qtip:'No2',leaf:true}??
- ????????????????]??
- ????????????});??
- ????????????var?root1=new?Ext.tree.TreeNode({??
- ????????????????text:'icon',??
- ????????????????icon:'user_female.png'??
- ????????????});??
- ????????????tree.setRootNode(root);???
- ????????????//root.expand(true,true);??
- ????????????var?contextmenu=new?Ext.menu.Menu({??
- ????????????????id:'theContextMenu',??
- ????????????????????items:[{??
- ????????????????????????text:'点击',??
- ????????????????????????handler:function(){??
- ????????????????????????????alert('我被点中了');??
- ????????????????????????}??
- ????????????????????}]??
- ????????????});??
- ????????????tree.on("contextmenu",function(node,e){??
- ????????????????e.preventDefault();??
- ????????????????node.select();??
- ????????????????contextmenu.showAt(e.getXY());??
- ????????????});??
- ????????????tree.on("click",function(node){??
- ????????????????Ext.Msg.show({??
- ????????????????????title:'提示',??
- ????????????????????msg:"你单击了"+node,??
- ????????????????????animEl:node.ui.textNode??
- ????????????????});??
- ????????????});??
- ????????????tree.render();????????????????????????
- ?????????????????????????
- ????????});??
- </script>??
?
九、为节点设置超链接
虽然我们完全可以监听click事件,但是直接在节点树形中设置超链接的地址也是一个好主意,这是很多人想实现的功能,具体的代码如下:
?
- var?root=new?Ext.tree.AsyncTreeNode({??
- ????????????????text:'我是根',??
- ????????????????children:[??
- ????????????????????{text:'新浪网',qtip:'新浪网 ',leaf:true,href:'http://www.sina.com.cn'},??
- ????????????????????{text:'百度中国',qtip:'搜索引擎',leaf:true,href:'http://www.baidu.cn',hrefTarget:'_blank'}??
- ????????????????]??
- ????????????});??
?
?