在《Ext2.0布局类初探》一文我简单的分析了一下Ext 2.0的布局类,但是缺乏例子。本篇文章的目的就是为《Ext2.0布局类初探》一文作补充,写几个简单的例子,希望大家能从中加深布局类的认识。因为没有API,对Ext2.0布局类也是一知半解,难免会有错误,请大家见谅!
一、简单的例子
这个例子和《Ext布局类的介绍与使用》(下称Ext文)的例子是一样的,大家可以通过两个例子对比一下2.0版的和1.1版的区别,整体布局图如下:
|
|
和Ext文一样,我们先写好几个DIV:
<div id="north-div"></div> <div id="center-div">内容</div> <div id="south-div">状态栏</div> |
和Ext文一样,没什么改变。
因为是对整个页面做布局的,所以需要使用Viewport类,而不是象1.1那样定义一个borderlayout,然后把document.body作为其容器。我们先创建一个Viewpot类:
var viewport = new Ext.Viewport({ layout:'border', items:[ ] }); |
Viewprot类的创建很简单,只要定义一下布局的类型就行了,这里使用的是borderLayout。items就是我们需要定义布局和面板的地方。
我们首先加入north区域的面板定义(toolbar的定义我就不写了,和Ext文是一样的):
var viewport = new Ext.Viewport({ layout:'border', items:[ { border:false, region:'north', contentEl:'north-div', tbar:tb, height:26 } ] }); |
在定义里,region属性指定了布局区域为north。因为borderLayout是有边的,而这里并不需要边,所以要设置border属性为false。面板的容器元件是id为north-div的DIV,所以contentEl设置“north-div”。这里设置了顶部工具栏(tbar)为定义好的tb。区域的高度是26。
在这里也可以使用Ext. BoxComponent代替borderLayout,好处嘛,我也说不上。如果用BoxComponent,需要修改几个地方,第一个地方是修改HTML:
<div id="north-div"><div id="toolbar-div"></div></div> |
需要为工具栏增加一个div,因为BoxComponent里使用的是el属性指定它的容器,而不是用contentEl属性指定它的内容面板,所以要在容器里加一个工具栏的容器。完整代码如下:
new Ext.BoxComponent({ region:'north', el:'north-div', tbar:tb, height:26 }) |
因为BoxComponent是没有边的容器,所以不用设置它的border属性。还有一个变动的地方就是el代替了contentEl,原因是el属性指定的div是BoxComponent的容器,而panel里contentEl指定的是面板容器。
我们继续写center区域的代码:
new Ext.TabPanel({ region:'center', deferredRender:false, activeTab:0, items:[{ contentEl:'center-div', title: '内容', closable:true, autoScroll:true }] }) |
因为center区域使用电话tab面板,不是用默认的panel面板,所以要创建一个TabPanel,region指定了区域位置是center,deferredRender设置是否延缓面板的加载,这里设置是同时加载,activeTab设置了当前活动的tab页是第1页,这个一定要设置,不然内容页面会显示为空白。在items里定义了一个tab页,它的内容面板使用了预先写好的id为center-div的div元件。注意这里定义的也是内容面板,不是布局的容器。其它的属性和1.1版的tabPanel是一样的,因此属性说明可参考1.1版的API,这里我就不详细说明了。
最后是完成south区域了:
{ region:'south', contentEl:'south-div', height:28, margins:'0 0 0 0' } |
在这里没什么特别的地方,只是将外补丁设置为0了。在这里也可以用BoxComponent代替,好处是背景色会和tab标签页头的背景一样,不用自己再设置。面板的默认背景色是白色,自己还要做相应的设置。
从代码中可以看到,新的写法不再需要:
layout.beginUpdate(); layout.restoreState(); layout.endUpdate(); |
这样的好处就是使代码更加清晰明了,不会遗漏代码,尤其是当内部布局再划分的时候。
例子的完整代码如下:
Ext.onReady(function(){ var tb=new Ext.Toolbar('north-div');//创建一个工具条 tb.add(new Ext.Toolbar.SplitButton({ text: '文件', cls: 'x-btn-text-icon blist', menu : {items: [ {text: '新建', handler: onItemClick}, {text: '保存', handler: onItemClick}, {text: '加载', handler: onItemClick} ]}}), new Ext.Toolbar.MenuButton({ text: '编辑', cls: 'x-btn-text-icon blist', menu : {items: [ {text: '复制', handler: onItemClick}, {text: '粘贴', handler: onItemClick} ]}}) );
var viewport = new Ext.Viewport({ layout:'border', items:[ { border:false, region:'north', contentEl:'north-div', tbar:tb, height:26 }, new Ext.TabPanel({ region:'center', deferredRender:false, activeTab:0, items:[{ contentEl:'center-div', title: '内容', closable:true, autoScroll:true }] }), { region:'south', contentEl:'south-div', height:28, margins:'0 0 0 0' } ] });
function onItemClick(item){ alert(item.text); } }) |
最终效果图:
|
|
二、带内部布局的例子
和Ext文第二个例子布局一样:
|
|
第一步还是根据布局写好html代码:
<div id="north-div"><div id='toolbar-div'></div></div> <div id="west-div"></div> <div id='center-center'></div> <div id='center-south'></div> <div id="south-div">状态栏</div> |
这次north区域我们尝试使用BoxComponent:
new Ext.BoxComponent({ region:'north', el:'north-div', tbar:tb, height:26 }) |
这里的代码在简单的例子已经介绍过了我就不多说了。下面然后开始写west区域定义。因为west区域是一个树列表,用到treePanel,需要一个根节点,所以在viewport前代码前先加入根节点:
var root = new Ext.tree.TreeNode({ text: '文件夹', allowDrag:false, allowDrop:false });
root.appendChild( new Ext.tree.TreeNode({text:'收件箱',allowDrag:false}), new Ext.tree.TreeNode({text:'发件箱',allowDrag:false}), new Ext.tree.TreeNode({text:'联系人',allowDrag:false}), new Ext.tree.TreeNode({text:'已删除的邮件',allowDrag:false}) ); |
当然了,这个你也可以在界面完成后通过节点操作再加。
我们现在可以写west区域的定义了:
new Ext.tree.TreePanel({ region:'west', contentEl:'west-div', title:'树列表', split:true, 200, minSize: 175, maxSize: 400, collapsible: true, margins:'0 0 0 0', root:root }) |
这里比较特别的地方就是用TreePanel代替了默认的panel,设置了一个根节点root为先前定义的“root”变量。
和Ext文对比一下,是不是简单了很多?不用在布局容器里再定义一个div来放置树了,省去了树的创建代码。
下面来定义center区域:
{ region:'center', layout:'border', items:[ new Ext.grid.GridPanel({ region:'center', el:'center-center', title:'条目列表', ds: ds, cm: colModel, autoScroll: true }), { region:'south', contentEl:'center-south', title:'内容', split:true, collapsible:true, titlebar:true, height:200, minSize: 100, maxSize:400, collapsedTitle:'内容' } ] } |
从代码中可以看到,我们不指定在html代码中定义的div作为它的内容面板,它自己会去创建。我们只需要定义它的区域位置(region)为center。这里有一个很重要的定义,就是layout属性了,这里的属性值为“border”,意思就是其内部布局的划分是使用borderlayout作为布局的。
然后我们在items中划分两个布局,一个是center区域的表格,和south区域的内容显示面板。
因为需要显示表格,所以直接创建了一个GridPanel作为center区域的面板。它的属性定义和1.1版的没有太大区别。在这里只需要说明该区域的位置(center)和它的容器(el)是我们定义好的it为“center-center”的div。内部south区域的定义也没什么特殊的地方,这里就不一一说明了。
最后我们加入整体布局south区域的定义就完成了我们这里例子。这里south也采用BoxComponent,而不采用panel:
new Ext.BoxComponent({ region:'south', el:'south-div', height:24 }) |
例子的完整代码:
Ext.onReady(function(){ var tb=new Ext.Toolbar('toolbar-div');//创建一个工具条 tb.add(new Ext.Toolbar.SplitButton({ text: '文件', cls: 'x-btn-text-icon blist', menu : {items: [ {text: '新建', handler: onItemClick}, {text: '保存', handler: onItemClick}, {text: '加载', handler: onItemClick} ]}}), new Ext.Toolbar.MenuButton({ text: '编辑', cls: 'x-btn-text-icon blist', menu : {items: [ {text: '复制', handler: onItemClick}, {text: '粘贴', handler: onItemClick} ]}}) ); var root = new Ext.tree.TreeNode({ text: '文件夹', allowDrag:false, allowDrop:false });
root.appendChild( new Ext.tree.TreeNode({text:'收件箱',allowDrag:false}), new Ext.tree.TreeNode({text:'发件箱',allowDrag:false}), new Ext.tree.TreeNode({text:'联系人',allowDrag:false}), new Ext.tree.TreeNode({text:'已删除的邮件',allowDrag:false}) ); var myData = [ ['张三','测试',' ['李四','测试一',' ['王五','测试二',' ['刘六','测试三',' ['张三','测试四',' ['李四','测试五',' ['刘六','测试六',' ['张三','测试七',' ['李四','测试八',' ['王五','测试九',' ['刘六','测试六',' ['张三','测试七',' ['李四','测试八',' ['王五','测试九',' ['刘六','测试十',' ['张三','测试十一',' ['李四','测试十二',' ['王五','测试十三',' ['刘六','测试十四',' ['张三','测试十五',' ['李四','测试十六',' ['王五','测试十七',' ['刘六','测试十八',' ]; var ds = new Ext.data.Store({ proxy: new Ext.data.MemoryProxy(myData), reader: new Ext.data.ArrayReader({}, [ {name:'sender'}, {name:'title'}, {name:'sendtime'} ]) }); ds.load(); var colModel = new Ext.grid.ColumnModel([ {header:'发送人',100,sortable:true,dataIndex:'sender'}, {id:'title',header:'标题', 100,sortable:true,dataIndex:'title'}, {header:'发送时间',75,sortable:true,dataIndex:'sendtime'} ]); var viewport = new Ext.Viewport({ layout:'border', items:[ new Ext.BoxComponent({ region:'north', el:'north-div', tbar:tb, height:26 }), new Ext.tree.TreePanel({ region:'west', contentEl:'west-div', title:'树列表', split:true, 200, minSize: 175, maxSize: 400, collapsible: true, margins:'0 0 0 0', root:root }), { region:'center', layout:'border', items:[ new Ext.grid.GridPanel({ region:'center', el:'center-center', title:'条目列表', ds: ds, cm: colModel, autoScroll: true }), { region:'south', contentEl:'center-south', title:'内容', split:true, collapsible:true, titlebar:true, height:200, minSize: 100, maxSize:400, collapsedTitle:'内容' } ] }, new Ext.BoxComponent({ region:'south', el:'south-div', height:24 }) ] }); root.expand()
function onItemClick(item){ alert(item.text); } }) |
最终的效果如下:
|
|
通过两个例子,第一感觉就是Ext2.0的布局更简化和层次化了。不过发现了一个小bug,就是在缩小浏览器窗口的时候,如果center区域内部的south区域过大的话,会把center区域遮盖,这可能是我没有完全理解布局的书写规则造成。
这篇文章只是起一个抛砖引玉的作用,给大家使用Ext2.0进行页面布局做一个简单的介绍。因为个人水平有限和理解的偏差,会有不少错误,请大家见谅!如果大家在Ext2.0布局设计中碰到任何问题或疑问,欢迎与我联系,大家一起共同探讨,多谢!
本文的例程可点击这里下载。