现在的位置: 首页 > 综合 > 正文

ExtJS笔记–Ext.form.FormPanel(二)

2014年11月05日 ⁄ 综合 ⁄ 共 6533字 ⁄ 字号 评论关闭

1、layout : String 

此容器所使用的布局类型。如不指定,则使用缺省的Ext.layout.ContainerLayout类型。 当中有效的值可以是:accordion、anchor、border、cavd、column、fit、form和table。 针对所选择布局类型,可指定#layoutConfig进一步配置。

 

2、layoutConfig : Object 

选定好layout布局后,其相应的配置属性就在这个对象上进行设置。 (即与#layout配置联合使用)有关不同类型布局有效的完整配置信息,参阅对应的布局类:

Ext.layout.Absolute 

Ext.layout.Accordion 

Ext.layout.AnchorLayout 

Ext.layout.BorderLayout 

Ext.layout.CardLayout 

Ext.layout.ColumnLayout 

Ext.layout.FitLayout 

Ext.layout.FormLayout 

Ext.layout.TableLayout

 

3、bufferResize : Boolean/Number 

当设置为true(100毫秒)或输入一个毫秒数,为此容器所分配的布局会缓冲其计算的频率和缓冲组件的重新布局。如容器包含大量的子组件或这样重型容器,在频繁进行高开销的布局时,该项尤为有用。

 

4、activeItem : String/Number 

组件id的字符串,或组件的索引,用于在容器布局渲染时候的设置为活动。例如,activeItem: 'item-1'或activeItem: 0 index 0 = 容器集合中的第一项)。只有某些风格的布局可设置activeItem(如Ext.layout.Accordion、Ext.layout.CardLayout和 Ext.layout.FitLayout),以在某个时刻中显示一项内容。相关内容请参阅Ext.layout.ContainerLayout#activeItem。 

 

5、items : Mixed 

一个单独项,或子组件组成的数组,加入到此容器中。 每一项的对象类型是基于Ext.Component的

你可传入一个组件的配置对象即是lazy-rendering的做法,这样做的好处是组件不会立即渲染,减低直接构建组件对象带来的开销。 要发挥"lazy instantiation延时初始化"的特性,应对组件所属的登记类型的Ext.Component#xtype属性进行配置。

 

要了解所有可用的xtyps,可参阅Ext.Component。如传入的单独一个项,应直接传入一个对象的引用( 如items: {...})。多个项应以数组的类型传入(如items: [{...}, {...}])。

 

6、defaults : Object 

应用在全体组件上的配置项对象,无论组件是由#items指定,抑或是通过#add、#insert的方法加入,都可支持。 缺省的配置可以是任意多个容器能识别的“名称/值”, 假设要自动为每一个Ext.Panel项设置padding内补丁,你可以传入defaults: {bodyStyle:'padding:15px'}。

 

7、autoDestroy : Boolean 

若为true容器会自动销毁容器下面全部的组件,否则的话必须手动执行销毁过程(默认为true)。 

 

8、hideBorders : Boolean 

True表示为隐藏容器下每个组件的边框,false表示保留组件现有的边框设置(默认为false)。

 

9、defaultType : String 

容器的默认类型,用于在Ext.ComponentMgr中表示它的对象。(默认为'panel')

 

10、x : Number 

如果该组件是在一个定位的组件之中,可通过该属性返回组件的x本地(左边)坐标。 

 

11、y : Number 

如果该组件是在一个定位的组件之中,可通过该属性返回组件的y本地(顶部)坐标。 

 

12、pageX : Number 

如果该组件是在一个定位的组件之中,可通过该属性返回组件的x页面坐标。 

 

13、pageY : Number 

如果该组件是在一个定位的组件之中,可通过该属性返回组件的y页面坐标。 

 

14、height : Number 

此组件的高度(单位象素)(缺省为auto)。

 

15、width : Number 

此组件的宽度(单位象素)(缺省为auto)。 

 

16、autoWidth : Boolean 

True表示为使用width:'auto',false表示为使用固定宽度(缺省为false)。 注意:尽管许多组件都会继承该配置选项,但是不是全部的'auto' width都有效。 autoWidth:true的设定表示会依照元素内容自适应大小,Ext就不会过问宽度的问题。 

 

17、fieldLabel : String 

在组件旁边那里显示的label文本(默认为'')。 

此组件只有在Ext.form.FormLayout FormLayout布局管理器控制的容器下渲染才有用。 

 

18、labelStyle : String 

关于表单字段的label提示文本的CSS样式的“完全表达式(CSS style specification)”。默认为"",若容器的lableStyle有设置这样设置值。

此组件只有在Ext.form.FormLayout FormLayout布局管理器控制的容器下渲染才有用。                      

 

19、labelSeparator : String 

分隔符,就是每行表单中的label文本显示后面紧接着的那个分隔符(默认值是Ext.layout.FormLayout#labelSeparator,即缺省是分号“:”)。 如果指定空白字符串""就表示不显示所谓的“分隔符”。

此组件只有在Ext.form.FormLayout FormLayout布局管理器控制的容器下渲染才有用。 

 

20、hideLabel : Boolean 

True表示为完全隐藏label元素。默认下,即使你不指定fieldLabel都会有一个空白符插入,好让支撑field为一行。 设该值为true就不会有这个空白符了。 

此组件只有在Ext.form.FormLayout FormLayout布局管理器控制的容器下渲染才有用。 

 

21、clearCls : String 

关于field的清除样式(默认为“x-form-clear-left”)。

此组件只有在Ext.form.FormLayout FormLayout布局管理器控制的容器下渲染才有用。

 

22、id : String  

唯一的组件id(默认为自动分配的id)。 出于你打算用id来获取组件引用这一目的(像使用Ext.ComponentMgr#getCmp的情形),你就会送入一个你写好的id到这个方法。 提示:容器的元素即HTML元素也会使用该id渲染在页面上。如此一来你就可以采用CSS id匹配的规则来定义该组件的样式。 换句话说,实例化该组件时,送入不同的Id,就有对应不同的样式效果。

 

23、xtype : String 

用于登记一个xtype。

 

24、cls : String 

一个可选添加的CSS样式类,加入到组件的元素上(默认为'')。这为组件或组件的子节点加入标准CSS规则提供了方便。

 

25、overCls : String 

关于鼠标上移至该组件元素的CSS样式类,移出时撤销该样式的效果(默认为'')。该配置项在处理元素"active"或"hover"的时候很有用。 

 

26、style : String 

作用在组件元素上特定的样式。该值的有效格式应如Ext.Element#applyStyles。 

 

27、ctCls : String 

一个可选添加的CSS样式类,加入到组件的容器上(默认为'')。这为容器或容器的子节点加入标准CSS规则提供了方便。

 

28、hidden : Boolean 

渲染该组件为隐藏状态的(默认为false)

 

29、plugins : Object/Array 

针对该组件自定义的功能,是对象或这些对象组成的数组。一个有效的插件须保证带有一个init的方法以便接收属于Ext.Component类型的引用。当一个组件被创建后,若发现由插件可用,组件会调用每个插件上的init方法,传入一个应用到插件本身。这样,插件便能按照组件所提供的功能,调用到组件的方法或响应事件。 

 

30、renderTo : Mixed 

容器渲染的那个节点的id,或是DOM节点,又或者是与DIV相当的现有元素。 使用了这项配置后,不需要执行render()的方法。

 

31、stateful : Boolean 

组件记忆了一个状态信息,启动时候就根据这个标记获取状态信息。 组件必须设置其#stateId或#id,较有保障性, 而自动生成的id在跨页面加载的时候则不能保证一定不出现相同的情形。

为了能记忆状态,必须通过方法设置一个Ext.state.Provider的实例置于一个状态管理器之中, 然后才可以用Ext.state.Provider#set set与Ext.state.Provider#get get的方法,保存记忆和提取记忆。 可用内建的Ext.state.CookieProvider实现设置一个。

 

要设置页面的状态供应器: To set the state provider for the current page: 

 

32、stateId : String 

出于状态管理目的id,(默认是人为设置过的组件id,如果组件是自动生成的id那种那么该项是null。 参阅#stateful了解记忆与复原的机制。

 

33、autoEl : Mixed 

某种标签的字符串或者Ext.DomHelper DomHelper配置对象,用于创建承载此组件的元素。

一般而言你无须对其设置。对于这些基础类而言,就会使用div作为其默认的元素。 Ext类写得越复杂,组件的onRender方法产生的DOM结构就随之更为复杂。

该项是为创建形形色色的DOM元素而准备的,开发者可根据程序的特定要求去制定,如:

 

34、disabledClass : String 

当组件被禁用时作用的CSS样式类(默认为"x-item-disabled")。

 

35、allowDomMove : Boolean 

当渲染进行时能否移动Dom节点上的组件(默认为true)。

 

36、autoShow : Boolean 

True表示为在渲染的时候先检测一下有否关于隐藏的样式类(如:'x-hidden'或'x-hide-display'),有就移除隐藏的样式类(缺省为false)。 

 

37、hideMode : String 

这个组件是怎么隐藏的。可支持的值有"visibility" (css中的visibility),"offsets"(负偏移位置)和"display"(css中的display)-默认为“display”。 

容器可能是{@link Ext.layout.CardLayout card layout}或Ext.TabPanel TabPanel中的一员,会有隐藏/显未的情形,这种情形下最好将其hideMode模式设为"offsets"。这保证了计算布局时,组件仍有正确的高度和宽度,组件管理器才能顺利地测量。

 

38、hideParent : Boolean 

True表示为当隐藏/显示组件时对组件的容器亦一同隐藏/显示,false就只会隐藏/显示组件本身(默认为false)。例如,可设置一个hide:true的隐藏按钮在window,如果按下就通知其父容器一起隐藏,这样做起来比较快捷省事。 

 

39、listeners : Object 

 

 

 

公共事件事件  

1、clientvalidation( Ext.form.FormPanel this, Boolean valid ) 

2、

如果配置项monitorValid为true,那么为通知验证的状态(valid state)该事件将不断地触发。

侦听器会传入以下的参数:

this : Ext.form.FormPanel 

valid : Boolean 

如果客户端验证都通过的话传入一个true 

  

3、bodyresize( Ext.Panel p, Number width, Number height ) 

当面板的大小变化后触发。 

侦听器会传入以下的参数:

p : Ext.Panel 调节大小的面板。

width : Number 面板新宽度。

height : Number 面板新高度。

 

4、titlechange( Ext.Panel p, String t ) 

面板的标题有改动后触发。 

侦听器会传入以下的参数:

p : Ext.Panel 标题被改动的那个面板。

t : String 新标题。

 

5、iconchange( Ext.Panel p, String n, String o ) 

当面板的图标类设置了或改变了触发。 

侦听器会传入以下的参数:

p : Ext.Panel 图标类被改动的那个面板。

n : String 新图标类。

o : String 旧图标类

 

6、collapse( Ext.Panel p ) 

当面板被闭合后触发。 

侦听器会传入以下的参数:

p : Ext.Panel 闭合的那个面板

 

7、expand( Ext.Panel p ) 

当面板被展开后触发。

侦听器会传入以下的参数:

p : Ext.Panel 展开的面板。

 

8、beforecollapse( Ext.Panel p, Boolean animate ) 

当面板被闭合之前触发。若句柄返回false则取消闭合的动作。

侦听器会传入以下的参数:

p : Ext.Panel 正被闭合的面板。

animate : Boolean True表示闭合时带有动画效果。

 

9、beforeexpand( Ext.Panel p, Boolean animate ) 

当面板被展开之前触发。若句柄返回false则取消展开的动作。

侦听器会传入以下的参数:

p : Ext.Panel 正被展开的面板

animate : Boolean True表示闭合时带有动画效果。

 

10、beforeclose( Ext.Panel p ) 

当面板被关闭之前触发。 注意面板不直接支持“关闭”,不过在面板的子类(如Ext.Window)可支持即可调用该事件。 若句柄返回false则取消关闭的动作。

侦听器会传入以下的参数:

p : Ext.Panel 正被关闭的面板。

 

11、close( Ext.Panel p ) 

当面板被关闭后触发。 注意面板不直接支持“关闭”,不过在面板的子类(如Ext.Window)可支持即可调用该事件。 

侦听器会传入以下的参数:

p : Ext.Panel 已关闭的面板。

 

12、activate( Ext.Panel p ) 

当面板视觉上取消活动后触发。 注意面板不直接支持“取消活动”,不过在面板的子类(如Ext.Window)可支持即可调用该事件。 另外在TabPanel控制下子组件也会触发activate和deactivate事件。 

侦听器会传入以下的参数:

p : Ext.Panel 激活的面板。

 

13、deactivate( Ext.Panel p ) 

当面板视觉上“反激活”过后触发。 注意面板不直接支持“反激活”,但面板某些子类就支持(如Ext.Window)。 TabPanel控制其子面板的激活与反激活事件。

侦听器会传入以下的参数:

p : Ext.Panel 已反激活的面板。

抱歉!评论已关闭.