日期:2014-05-16  浏览次数:20294 次

extJs 2.0学习笔记(Ext.Panel篇四)

我刚才禁不住诱惑去看了一下Ext.Window的API文档,发现只是比Panel多了点什么最大化、最小化、关闭、置前、置后、动画引发目标设置、可调整大小这些功能。像什么标题栏、工具栏之类的东西在Ext.Panel早就封装好了。搞定了Ext.Panel终于可以闷声发大财罗。哈哈哈。
  这一文主要总结一下,panel的常见用法。

  一、使Panel的标题栏隐藏

  这是常有的事,常常,一个栏目并不需要标题。有什么办法呢,创建时config中加上:header:false。就ok了。

  二、如何使Panel能被拖动

  确保config中如下设置:

?var config1={title:'这是标题栏',
???? width:300,
???? height:300,
???? header:false,
???? floating:true,
???? renderTo:Ext.getBody(),
???? draggable:{
   insertProxy: false,
????
   onDrag : function(e){
   var pel = this.proxy.getEl();
   this.x = pel.getLeft(true);
   this.y = pel.getTop(true);
????
   var s = this.panel.getEl().shadow;
   if (s) {
     s.realign(this.x, this.y, pel.getWidth(), pel.getHeight());
   }
?????? },
????
  endDrag : function(e){
    this.panel.setPosition(this.x, this.y);
?????? }
???? },
???? html:'这是面板的内容!!!',
???? layout:'fit',
???? collapsible:true};

  好了,关键就是上面红色部分了,由前面的文档可知:Ext.Panel.DD这个类只是提供移动Proxy元素的效果,鼠标一松,panel仍在老地方,所以得写代码实现。关于Ext.Panel.DD,这个类是非公开的,我在源代码中也没有找到。不晓得放在哪。最后,我只得打开 FireFox+FireBug才看到它里面的东西。

  为什么一定要floating:true呢?原因很简单,要能拖动,那么这个div就是absolute的,而一个panel.el默认不会是absolute。所以非得设成floating,以让它能浮动。

  三、如何有Panel能折叠、展开效果。

  这个很简单,panel在title tools中提供一个toggle的工具,就是用它干这事的,不过,默认情况下,panel的这个功能是被关闭的。panel还提供一个功能,单击 title的任意一处都会产生toggle collapse效果。相关的config属性我提出来如下:

  animCollapse : Boolean

  collapseFirst : Boolean

  collapsed : Boolean

  collapsedCls : String

  collapsible : Boolean  //事实上,把它设成true就ok了,其它几个可以不设置。

  titleCollapse : Boolean

  关于它们的使用说明请参见前面的API文档。不过,单看名字应当就晓得用了,取名很直观。

  四、怎样为panel设置title tools。

  就是怎样为Panel的标题栏添加按钮,这个容器,在config中类似如下代码即可:

  tools:[{id:close,handler:function(event, toolEl, panel){panel.hide();}}],

  格式一般是:tools:[{……},{……},{……}]

  五、怎样显示、隐藏panel

  这个很容易,panel.show()/hide()就行了。但是,如果floating:true的话,那就麻烦了,show都显示不了,我在FireBug中一看,panel.el.dom.style.left="-10000px"。这当然是显示不出来的。所以,你show了还要 setPosition一下。这才行了。

  六、为panel添加子组件

  简单,在config中加items属性,类似于如下代码:

  items:[{id:'win1',xtype:'window',title:'title',height:100,width:100}],

  格式一般是:items:[{……},{……},{……}]

  如果在定义时,没有设置xtype,则子组件创建是xtype取defaultType的值。像上面,由于window创建后是不显示的,所以,只得show出来。所以,我在定义时给它一个id。这样在Ext.onReady()中就可以:Ext.getCmp("win1").show()。嘿,就出来了。其他组件的加入类似。一个{}是一个组件。

  像上面那样的叫惰性呈现,还有一种写法是:items:[new XXX(config)]。这样的定义会在组件创建时直接呈现。

  七、为panel设置布局

  这个是关键了。就是要设layout、layoutConfig。这个要详细的讲一下。平常要用嘛。这儿用BorderLayout的文档上的代码为例:

???? layout:'border',
???? items: [{
?????? title: 'South Panel',
?????? region: 'south',
?????? height: 100,
?????? minSize: 75,
?????? maxSize: 250,
?????? margins: '0 5 5 5'
????? },{
?????? title: 'West Panel',
?????? region:'west',
?????? margins: '5 0 0 5',
?????? cmargins: '5 5 0 5',
?????? width: 200,
?????? minSize: 100,
?????? maxSize: 300
????? },{
?????? title: 'Main Content',
?????? region:'center',
?????? margins: '5 5 0 0'
????? }],

  其实,布局类的api接口很简单,使用也不复杂。果然是把swing的那一套学过来了。

  Ext.layout.BorderLayout是一个比较特殊的布局类,它没有什么正儿八经的config,不像Panel它们。只需设一下 layout,然后,在成员组件那儿用region标明是哪个区域就是了。Ext.layout.BorderLayout把一块地盘分成五个区:east、west、south、north、center。

  我个人非常喜欢这个布局,因为以它作为外层布局的话,就能很方便的实现cnblogs一样的效果,我到现在还不知道那个左边列固定宽,右边列占满剩余屏幕的布局是怎么搞的,除非写javascript代码在window.onload中手工调,否则,全靠css,真的是想不出办法来,后来,我也找到一个办法:用table。table有一个特性,可以把它设成占满整个水平方向,第一列固