在应用程序中,我们经常需要显示或处理树状结构的对象信息,比如部门信息和地区信息,树是一种非常典型的数据结构,这些信息都可以用树来表示。对于传统的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的提示功能进行初始化。
上面这行代码必须在其他功能加载前完成,建议写在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);
-
- 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'}
- ]
- });
|