EXT 核心 API 详解


1 EXT 核心 API 详解 1、Ext 类 ………………………………… 2 2、Array 类 …………………………… 4 3、Number 类 …………………………… 4 4、String 类 …………………………… 4 5、Date 类 ……………………………… 5 6、Function 类 ………………………… 6 7、Ext.Element 类 ………………………… 7 8、Ext.DomQuery 类 ………………… 13 9、Ext.DomHelper 类 …………………… 14 10、Ext.Template 类 …………………… 14 11、Ext.EventManager 类 ……………… 15 12、Ext.EventObject 类 ………………… 15 13、Ext.CompositeElement 类 ………… 16 14、Ext.CompositeElementLite 类 ……… 16 15、Ext.Fx 类 …………………………… 16 16、Ext.KeyNav 类 ……………………… 19 17、Ext.KeyMap 类 …………………… 19 18、Ext.util.JSON 类 ……………………… 20 19、Ext.util.Format 类 ………………… 20 20、Ext.util.DelayedTask 类 ……………… 20 21、Ext.util.TaskRunner 类 …………… 21 22、Ext.util.TextMetrics 类 …………… 21 23、Ext.XTemplate 类 ………………… 21 24、Ext.data.Connection 类 ……………… 22 25、Ext.Ajax 类 ………………………… 22 26、Ext.data.Record 类 ………………… 23 27、Ext.data.DataProxy 类 …………… 24 28、Ext.data.HttpProxy 类 …………… 24 29、Ext.data.MemoryProxy 类 ……… 25 30、Ext.data.ScriptTagProxy 类 ………… 25 31、Ext.data.DataReader 类 ……………26 32、Ext.data.ArrayReader 类 …………… 26 33、Ext.data.JsonReader 类 …………… 26 34、Ext.data.XmlReader 类 …………… 27 35、Ext.data.Store 类 …………………… 28 36、Ext.data.GroupingStore 类 ………… 32 37、Ext.data.SimpleStore 类 ………… 34 38、Ext.data.Tree 类 …………………… 34 39、Ext.data.Node 类 ………………… 34 40、Ext.Action 类 ……………………… 35 41、Ext.Button 类 …………………… 36 42、Ext.SplitButton 类 ……………… 38 43、Ext.CycleButton 类 ……………… 39 44、Ext.form.BasicForm 类 …………… 40 45、Ext.form.Field 类 …………………… 41 46、Ext.form.Checkbox 类 …………… 42 47、Ext.form.Radio 类 ………………… 43 48、Ext.form.HtmlEditor 类 …………… 43 49、Ext.form.TextField 类 …………… 44 50、Ext.form.NumberField 类 ………… 44 51、Ext.form.TextArea 类 …………… 45 52、Ext.form.TriggerField 类 ……… 45 53、Ext.form.DateField 类 ………… 45 54、Ext.form.ComboBox 类 ……………… 46 55、Ext.form.TimeField 类 ………… 47 56、Ext.menu.Menu 类 ………………… 50 57、Ext.menu.BaseItem 类 …………… 50 58、Ext.menu.Adapter 类 ……………… 51 59、Ext.menu.Item 类 ………………… 51 60、Ext.menu.CheckItem 类 …………… 51 61、Ext.menu.Separator 类 ………… 52 62、Ext.menu.TextItem 类 …………… 52 63、Ext.Toolbar 类 …………………… 55 64、Ext.Toolbar.Item 类 ……………… 56 65、Ext.Toolbar.Separator 类 ……… 56 66、Ext.Toolbar.Spacer 类 …………… 56 67、Ext.Toolbar.TextItem 类 ……… 56 68、Ext.Toolbar.Fill 类 ……………… 56 69、Ext.grid.ColumnModel 类 ……… 58 70、Ext.grid.PropertyColumnModel 类 … 59 71、Ext.grid.GridView 类 …………… 59 72、Ext.grid.GroupingView 类 ………… 60 73、Ext.grid.EditorGridPanel 类 ……… 62 74、Ext.grid.PropertyGrid 类 …………… 65 2 1、Ext 类 addBehaviors(Object obj) : void 对选择的元素 应用事件侦听器,事件名以@附加在结尾,例如 addBehaviors({ // id=foo 下所有的 a 标签加入 click 事件 '#foo a@click' : function(e, t){ // do something }, // 用,分隔多个选择器 '#foo a, #bar span.some-class@mouseover' : function(){ // do something } }); apply( Object obj, Object config, Object defaults ) : Object 从 config 拷贝所有的属性到 obj,如果有 defaults 参数,也将拷贝其属性到 obj applyIf( Object obj, Object config ) : Object 从 config 拷贝所有属性至 obj(如果 obj 未定义相应属性) decode(Object obj) : String 编码一个对象/数组或其它值为一个 json 格式字符串(支持对象,数组,日期,字符串) destroy( Mixed arg1, Mixed (optional), Mixed (optional) ) : void 尝试去移除每个传入的对象,包括 DOM,事件侦听者,并呼叫他们的 destroy 方法(如果存在) each( Array/NodeList/Mixed array, Function fn, Object scope ) : void 利用 array 中的每个元素迭代调用 fn.直到 fn 返回假,调用格式 fn.call(scope || array[i], array[i], i, array); encode(String json) : Object 将一个 json 格式字符串反序列化为对象 escapeRe( String str ) : String 为字符串正则编码将.在*+?^${}()|[]/\字符前加\ extend( Object subclass, Object superclass, [Object overrides] ) : void 从 superclass 类继承 subclass,overrides 参数是要重载的方法列表,详见 override fly( String/HTMLElement el, [String named] ) : Element 得到全局共享的一个浮动元素 el,如果有多个浮动元素可以使用命名以避免潜在的冲突 get( Mixed el ) : Element 得到一个 Element 对象,参数可以是 id 或 DOM 节点或已存在的 Element 对象 getBody() : Element 得到当前文档的 body 对象 getCmp( String id ) : Component 通过 id 得到一个 Component 对象 getDoc() : Element 得到当前文档 getDom( Mixed el ) : HTMLElement 通过 id 或节点或 Element 对象返回一个 DOM 节点 id( [Mixed el], [String prefix] ) : String 为对象 el 生成一个惟一 id,如果对象本身已有 id,将不会被改变(可以使用前导符 prefix) isEmpty( Mixed value, [Boolean allowBlank] ) : Boolean 判断值是否为空,null, undefined 或空字符串将返回真,如果 allowBlank 定义为真,空字符串将不被视为空 namespace( String namespace1, String namespace2, String etc ) : void 创建一个命名空间,例 Ext.namespace('Company', 'Company.data'); Company.Widget = function() { ... } 3 Company.data.CustomStore = function(config) { ... } num( Mixed value, Number defaultValue ) : Number 将 value 转为数值,如果 value 不是合法的数值类型,将返回 defaultValue,其实 defaultValue 并不一定要求是数值 类型,只要你愿意 onReady( Function fn, Object scope, boolean override ) : void 当文档准备好了之后引发 fn,发生在 page 的 onload 事件之前,并且图片此时都还没有载入,scope 定义执有 者,override 定义 scope 是否有默认的选择 override( Object origclass, Object overrides ) : void 利用 overrides 重写 origclass 的方法,例 Ext.override(MyClass, { newMethod1: function(){ // etc. }, newMethod2: function(foo){ // etc. } }); query( String path, [Node root] ) : Array 通过 path,在 root 中选择节点数组,path 可以是以下四种选择器之一 [元素选择器] 例: * 任意节点 E 一个 E 标签元素 E F 祖先节点为 E 的 F 节点 E > F 或 E/F 父节点为 E 的 F 节点 E + F 前一个兄弟节点为 E 的 F 节点 E ~ F 前面的兄弟节点中有 E 的 F 节点 [属性选择器] 例: E[foo] 有 foo 属性的 E 节点 E[foo=bar] 有 foo 属性值为 bar 的 E 节点 E[foo^=bar] foo 属性以 bar 开始的 E 节点 E[foo$=bar] foo 属性以 bar 结尾的 E 节点 E[foo*=bar] foo 属性中有 bar 字符串的 E 节点 E[foo%=2] foo 属性能被 2 整除的 E 节点 E[foo!=bar] foo 属性值不为 bar 的 E 节点 [伪类选择器] 例: E:first-child E 节点是父节点中第一个子节点 E:last-child E 节点是父节点中最后一个子节点 E:nth-child(n) E 是父节点中每 n 个节点 E:nth-child(odd) E 是父节点中的奇数节点 E:nth-child(even) E 是父节点中的偶数节点 E:only-child E 是父节点中惟一的子节点 E:checked checked 属性为真的节点 E:first 子孙节点中的第一个 E 节点 E:last 子孙节点中的最后一个 E 节点 E:nth(n) 子孙节点中的第 n 个 E 节点 4 E:odd E:nth-child(odd)的简写 E:even E:nth-child(even)的简写 E:contains(foo) innerHTML 属性中含有 foo 的 E 节点 E:nodeValue(foo) E 节点中包含一个值为 foo 的文本节点 E:not(S) 不匹配简单选择器 S 的 E 节点 E:has(S) 有能匹配简单选择器 S 的子节点的 E 节点 E:next(S) 下一个兄弟节匹配简单选择器 S 的 E 节点 E:prev(S) 前一个兄弟节匹配简单选择器 S 的 E 节点 type( Mixed object ) : String 判断对象类型,如果不是下列值之一将返回 false [样式选择器] 例: E{display=none} display 属性值为 none 的 E 节点 E{display^=none} display 属性值以 none 开始的 E 节点 E{display$=none} display 属性值以 none 结束的 E 节点 E{display*=none} display 属性值含有 none 子字串的 E 节点 E{display%=2} display 属性值能被 2 整除的 E 节点 E{display!=none} display 属性值不等于 none 的 E 节点 select( String/Array selector, [Boolean unique], [HTMLElement/String root] ) :CompositeElementLite/CompositeElement 在 root 内通过样式选择器或元素数组 selector 选择元素或元素列表,unique 指示是否只选择惟一值 urlDecode( String string, [Boolean overwrite] ) : Object 将 url 格式字符串 string 解码为 json 对象,overwrite 参数指示是否不重写已存在的对象,例 Ext.urlDecode("foo=1&bar=2"); //返回 {foo: 1, bar: 2} Ext.urlDecode("foo=1&bar=2&bar=3&bar=4"); //返回 {foo: 1, bar: 4}. Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", true); //返回 {foo: 1, bar: [2, 3, 4]}. urlEncode( Object o ) : String 将 json 对象编码为 url 格式字符串,参见 urlDecode type( Mixed object ) : String 得到 object 类型,如果不为以下列举值之一则返回 false 2、Array 类 indexOf( Object o ) : Numberobject 是否在数组中,找不到返回-1;找到返回位置 remove( Object o ) : Array 从数组中删除指定的对象 object,如果找不到 object 则数组无变化 3、Number 类 constrain( Number min, Number max ) : Number 检查数值是否介于 min 与 max 之间, 如果大于 max 返回 max,如果小于 min 返回 min, 否则返回当前值 4、String 类 escape( String string ) : String 将 string 中的'和\替换为\' \\ format( String string, String value1, String value2 ) : String 格式化字符串, 例: var cls = 'my-class', text = 'Some text'; var s = String.format('
{1}
', cls, text);// 结果
Some text
5 leftPad( String string, Number size, [String char] ) : String 以 char 将 string 补齐为 size 长度,char 默认定义空格 toggle( String value, String other ) : String 交换值,如果当前值等于 value,则被赋值 other,反之等于 value,例: sort = sort.toggle('ASC', 'DESC'); trim() : String 去除开头或结尾多余的空格 5、Date 类 Date.parseDate( String input, String format ) : Date 将字符串 string 依指定的格式 format 转换为时间,其中格式定义详见 format 方法 例:dt = Date.parseDate("2006-01-15 3:20:01 PM", "Y-m-d h:i:s A" ); add( String interval, Number value ) : Date 增加时间段,String interval 在 Data 类中已定义 Date.MILLI = "ms"; Date.SECOND = "s"; Date.MINUTE = "mi"; Date.HOUR = "h"; Date.DAY = "d"; Date.MONTH = "mo"; Date.YEAR = "y"; 例 var dt2 = new Date('10/1/2006').add(Date.DAY, -5); between( Date start, Date end ) : Boolean 是否在两个指定的时间之间 clearTime( Boolean clone ) : Date 清除时间信息,如果 clone 为真,则克隆自已并返回新 Date,本身的值并不改变,反之则修改自身的值 clone() : Date 克隆 format( String format ) : String 格式化时间 d 两位数的日期 01 至 31 D 三字母的星期名 Mon 至 Sun j 一位数的日期 1 至 31 l 完整的星期名 Sunday 至 Saturday S 日期的英文顺序刻词尾,两个字符 st, nd, rd or th. w 一周中的第几天 0 (星期天) 至 6 (星期六) z 一年中的第几天 0 至 364 (闰年 365 ) W ISO-8601 星期数, 周一算一个星期的开始 1 至 53 F 月的完整英文名 January 至 December m 月,以 0 前导 01 至 12 M 三字母的简写月名 Jan 至 Dec n 月 1 至 12 t 本月有多少天 28 至 31 L 是否闰年 1/0 Y 完整的年份 例: 1999 或 2003 y 年的后两位 例: 99 或 03 a 上午/下午小写 am 或 pm A 上午/下午大写 AM 或 PM g 小时/12 小时制 1 至 12 6 G 小时/24 小时制 0 至 23 h 小时/12 小时制 01 至 12 H 小时/24 小时制 00 至 23 i 分钟 00 至 59 s 秒 00 至 59 u 毫秒 001 至 999 O 时区,与格林威治标准时间之差 例: +0200 T 时区简写 例: EST, MDT ... Z 时区间距 -43200 至 50400 其中 Date 类内置了几种格式 Date.patterns = { ISO8601Long:"Y-m-d H:i:s", ISO8601Short:"Y-m-d", ShortDate: "n/j/Y", LongDate: "l, F d, Y", FullDateTime: "l, F d, Y g:i:s A", MonthDay: "F d", ShortTime: "g:i A", LongTime: "g:i:s A", SortableDateTime: "Y-m-d\\TH:i:s", UniversalSortableDateTime: "Y-m-d H:i:sO", YearMonth: "F, Y" }; 当然 ISO8601Long 和 ISO8601Short 还是非常招人喜欢的 例: dt.format(Date.patterns.ISO8601Long); dt.format('Y-m-d H:i:s'); getDayOfYear() : Number 一年中的第几天,从 0 开始 getDaysInMonth() : Number 本月有多少天, getElapsed( [Date date] ) : Number 当前日期对象与 date 之间相差的毫秒数 getFirstDateOfMonth() : Date 本月的第一天 getFirstDayOfMonth() : Number 本月第一天是星期几 getGMTOffset() : String 时区信息(见格式定义中的'O') getFirstDateOfMonth() : Date 本月最后一天 getFirstDayOfMonth() : Number 本月最后一天是星期几 getSuffix() : String 日期后导符(见格式定义中的 S) getTimezone() : String 时区(见 T) getWeekOfYear() : Number 一年中的第几周(见 W) isLeapYear() : Boolean 是否闰年 6、Function 类 createCallback(/*args...*/) : Function 创建回叫方法 createDelegate( [Object obj], [Array args], [Boolean/Number appendArgs] ) : 创建委托 7 这两个记法除了传参方式不同,看不出有什么差异都是调用 method.apply,createCallback 可以看作一个简化 版的 createDelegate createCallback==>return method.apply(window, args); createDelegate==>return method.apply(obj || window, callArgs); 前者参数比较简单,直接传过去了,后者的规则比较复杂点,如果 appendArgs 为真,args 将附加在参数列表之后, 如果是数值,args 将在参数列表的 appendargs 位置插入,其它情况下原参将不起作用 例: var fn = func1.createDelegate(scope, [arg1,arg2], true) //fn(a,b,c) === scope.func1(a,b,c,arg1,arg2); var fn = func1.createDelegate(scope, [arg1,arg2]) //fn(a,b,c) === scope.func1(arg1,arg2); var fn = func1.createDelegate(scope, [arg1,arg2], 1) //fn(a,b,c) === scope.func1(a,arg1,arg2,b,c); var fn = func1.createCallback(arg1, arg2); //fn() === func1(arg1, arg2) createCallback : function(/*args...*/) createInterceptor( Function fcn, [Object scope] ) : Function 创建阻断方法,如果 fcn 返回 false,原方法将不会被执行 createSequence( Function fcn, [Object scope] ) : Function 创建组合方法,执行原方法+fcn defer( Number millis, [Object obj], [Array args], [Boolean/Number appendArgs] ):Number 定时执行,隔 millis 毫秒后执行原方法 7、Ext.Element 类 Element( String/HTMLElement element, [Boolean forceNew] ) 由 id 或 DOM 节点创建 Element 对象 Element.fly( String/HTMLElement el, [String named] ) : Element 由 id 或 DOM 节点创建一个全局共享的活动元素,可由 named 命名以避免可能的冲突 Element.get( Mixed el ) : Element 由 id 或 DOM 节点或已存在的 Element 得到一个 Ext.Element 对象 addClass( String/Array className ) : Ext.Element 为元素添加一个或多个 css 类名 addClassOnClick( String className ) : Ext.Element 为点击事件添加和移除 css 类 addClassOnFocus( String className ) : Ext.Element 为得到和失去焦点添加和移除 css 类 addClassOnOver( String className, [Boolean preventFlicker] ) : Ext.Element 为鼠标移入移出事件添加和移除 css 类(该方法未实际使用 preventFlicker 参数) addKeyListener( Number/Array/Object/String key, Function fn, [Object scope] ) : Ext.KeyMap 为对象添加按键侦听 key 由数值或字符串或{key: (number or array), shift: (true/false), ctrl: (true/false), alt: (true/false)}这样的对象或他们的数组组成 addKeyMap( Object config ) : Ext.KeyMap 功能同 addKeyListener,只是传参方式不同 例: el.addKeyMap({key : "ab",ctrl : true,fn: fn,scope:el }); 和 el.addKeyListener({key:"ab",ctrl:true},fn,el); 是等价的,都是在 按下 ctral+a 或 ctrl+b 后呼叫 fn addListener( String eventName, Function fn, [Object scope], [Object options] ) : void 8 定义事件侦听,eventName:事件名,fn:事件处理方法,scrope:范围,其中 options 的定义比较复杂,可以包含以下 属性 scope {Object} : 处理 fn 的范围 delegate {String} : 一个简单选择器(过滤目标或寻找目标的子孙节点) stopEvent {Boolean} : 阻止事件,等于 preventDefault+stopPropagation preventDefault {Boolean} : 阻止默认活动 stopPropagation {Boolean} : 阻止事件冒泡 normalized {Boolean} :设为 flase 将允许浏览器事件替代 Ext.EventObject delay {Number} : 延时多少毫秒后发生 single {Boolean} : 只运行一次 buffer {Number} : 在 Ext.util.DelayedTask 中预定事件 当然,还可能自定义参数以传入 function alignTo( Mixed element, String position, [Array offsets], [Boolean/Object animate] ) : Ext.Element 将 el 对齐到 element,positon,指示对齐的位置,可选以下定义 tl 左上角(默认) t 上居中 tr 右上角 l 左边界的中央 c 居中 r 右边界的中央 bl 左下角 b 下居中 br 右下角 position 还可以使用?约束移动不能超出窗口 offsets 偏移量,以象素为单位 animate 详见 animate 定义 例:div1.alignTo('div2','c-bl?',[20,0],true); 采用默认动画将 div1 的最中央对齐到 div2 的左下角,并右移 20 个象素,且不能超出窗口 anchorTo( Mixed element, String position, [Array offsets], [Boolean/Object animate], [Boolean/Number monitorScroll], Function callback ) : Ext.Element 功能和 alignTo 类似,只是当窗口重定义大小的时候也会引发重对齐事件 monitorScroll参数说明是否需要监视滚动条行为,如果定义为数值则是定义的延时,单位为毫秒,默认是50ms, callback 定义了 animate 完成后的回叫方法 animate( Object args, [Float duration], [Function onComplete], [String easing], [String animType] ) : Ext.Element 执行动画. args:目标 duration:时间间隔.默认是 0.35 Function:完成后的回叫方法 easing:行为方法 默认值是:easeOut,可选值在 ext_base 中找到,但没有说明,以下内容从 yahoo ui 中找到的 easeNone:匀速 easeIn:开始慢且加速 easeOut:开始快且减速 9 easeBoth:开始慢且减速 easeInStrong:开始慢且加速,t 的四次方 easeOutStrong:开始快且减速,t 的四次方 easeBothStrong:开始慢且减速,t 的四次方 elasticIn: elasticOut: elasticBoth: backIn: backOut: backBoth: bounceIn: bounceOut: bounceBoth: 太多,慢慢体会吧 animType:定义动画类型,默认值 run 可选值:color/motion/scroll appendChild( String/HTMLElement/Array/Element/CompositeElement el ) : Ext.Element 添加子元素 el(el 须已存在) appendTo( Mixed el ) : Ext.Element 将当前元素添加到 el applyStyles( String/Object/Function styles ) : Ext.Element 应用样式,styles 是"width:100px"这样的字符串或{width:"100px"}这样的对象,function 是指返回这样的字串 和对象的函数,这是一个没有用的批示,因为任何传参的地方都可以是返回要求类型的 function.另见 setStyle autoHeight( [Boolean animate], [Float duration], [Function onComplete], [String easing] ) : Ext.Element 自适应高度,参数都是老相识了,惟一需要注意的是这个方法使用了 setTimeout,高度不会马上变更 blur() : Ext.Element 失去焦点,忽略所有的异常 boxWrap( [String class] ) : Ext.Element 用一个指定样式 class 的 div 将当前元素包含起来,class 默认值为 x-box center( [Mixed centerIn] ) : void alignTo 的简华版.相当于 alignTo(centerIn || document, 'c-c'),当前元素的中心对齐到 centerIn 元素的中心 child( String selector, [Boolean returnDom] ) : HTMLElement/Ext.Element 依 selector 选择子孙节点,依 returnDom 不同批示返回 html 元素还是 ext 元素,未定义或 false 时返回 Ext.Element clean( [Boolean forceReclean] ) : void 清除无用的空白文本节点(我喜欢这个想法) clearOpacity() : Ext.Element 清除当前元素样式中不通用元素,清除 ie 中的 filter,清除 FF 中的 opacity/-moz-opacity/-khtml-opacity clearPositioning( [String value] ) : Ext.Element 清除定位,恢复到默认值,相当于 this.setStyle({"left": value,"right": value,"top": value,"bottom": value,"z-index": "","position" : "static"}); clip() : Ext.Element 裁剪溢出部分,用 unclip()恢复 contains( HTMLElement/String el ) : Boolean 当前元素中是否存在 el createChild( Object config, [HTMLElement insertBefore], [Boolean returnDom] ) : Ext.Element 创建一个新的子节点 config :DomHelper 元素对象,如果没有特别指明 tag,将使用 div 做默认 tag,详情参见 DomHelper,如果未定义 insertBefore,则追加 10 createProxy( String/Object config, [String/HTMLElement renderTo], [Boolean matchBox] ) : Ext.Element 创建一个代理元素 config:代理元素的类名或 DomHelper config 对象 renderTo:将要绘制代理元素的 html element 或 id matchBox:是否对齐 createShim() : Ext.Element 在当前元素之前创建一个 classname 为 ext-shim 的 iframe,有什么用? down( String selector, [Boolean returnDom] ) : HTMLElement/Ext.Element 通过样式选择器 selector 选择子孙节点 enableDisplayMode( [String display] ) : Ext.ElementsetVisibilityMode 的简便方法 findParent( String selector, [Number/Mixed maxDepth], [Boolean returnEl] ) : HTMLElement 通过简单选择器 selector 寻找祖先节点 ,直到 maxDepth(元素 maxDepth 默认为 10,也可以是指定的 DOM 节 点),找不到返回 null findParentNode( String selector, [Number/Mixed maxDepth], [Boolean returnEl] ) : HTMLElement 从父元素开始使用简单选择器 selector 选择 DOM 节点 first( [String selector], [Boolean returnDom] ) : Ext.Element/HTMLElement 得到第一个符合 selector 条件的子节点,跳过文本节点 focus() : Ext.Element 得到焦点 getAlignToXY( Mixed element, String position, [Array offsets] ) : Array 得到当前元素按 position 规则对齐到 element 时的 XY 坐标值 position/offsets 参数参见 alignTo 方法 getAnchorXY( [String anchor], [Object size], [Boolean local] ) : Array 得到当前元素锚点指定的坐标值 anchor 定义参见 alignTo 方法,默认为 c getAttributeNS( String namespace, String name ) : String 得到使用了命名空间 namespace 的属性 name 之值, getBorderWidth( String side ) : Number 得到 side 指定的边框之和,side 可以是 t, l, r, b 或他们的任意组合,比如 getBorderWidth("lr")就是得到左边框 和右边框之和 getBottom( Boolean local ) : Number 得到当前元素的底部纵坐标,元素纵坐标+元素高度 getBox( [Boolean contentBox], [Boolean local] ) : Object 得到当前元素的 box 对象:{x,y,width,height} getCenterXY() : Array 如果当前元素要居中对齐时的横纵坐标值,等价 getAlignToXY(document, 'c-c') getColor( String attr, String defaultValue, [String prefix] ) : void 得到当前元素指定 attr 的颜色值,如果没指定,返回 defualtValue,比较郁闷的是明明不是 void 为什么 api 中批 示是一个 void?应该是个字符串 getComputedHeight() : Number 得到计算过的高度,得到 offsetHeight 或 css 中定义的 height 值之一,如果使用了 padding/borders,也会计算进 去 getComputedWidth() : Number 见 getComputedHeight getFrameWidth( String sides ) : Number 得到 sides 定义的 border 宽度和 padding 定义的宽度之和,side 定义见 getBorderWidth getHeight( [Boolean contentHeight] ) : Number 返回元素的 offsetHeight getLeft( Boolean local ) : Number 得到横坐标 getMargins( [String sides] ) : Object/Number 如果没有定义 sides,则返回一个含有{left,top,width,height}对象,反 之返回 side 指定的宽度,side 定义见 getBorderWidth getOffsetsTo( Mixed element ) : Array 计算从 element 到当前元素的偏移量 getPadding( String side ) : Number 得到由 side 指定的 padding 之和 11 getPositioning() : Object 得到当前元素的位置信息 返回含以下属性的对象{position,left,right,top,bottom,z-index} getRegion() : Region 得到当前元素的区域信息 返回含有以下属性的 Ext.lib.Region 对象{top, left, bottom, right} getRight( Boolean local ) : Number 右边界值 getScroll() : Object 得到一个批示滚动条位置的对象{left, top} getSize( [Boolean contentSize] ) : Object 得到宽度和高度组成的对象信息{width,height} getStyle( String property ) : String 得到指定的样式值 getStyles 简化版 getStyles( String style1, String style2, String etc. ) : Object 得到由参数组成的对象 例:el.getStyles('color', 'font-size', 'width') 可能返回 {'color': '#FFFFFF', 'font-size': '13px', 'width': '100px'} getTop( Boolean local ) : Number 得到顶点纵坐 标 getUpdater() : Ext.Updater 得到当前元素的 Updater 对象,参见 Ext.Updater 类 getValue( Boolean asNumber ) : String/Number 得到 value 属性的值 getViewSize() : Object 得到 clientHeight 和 clientWidth 信息给成的对象{width,height} getWidth( [Boolean contentWidth] ) : Number..这样的方法真多 getX() : Number 得到页面偏移量,也就是绝对坐标 getXY() : Array getY() : Array hasClass( String className ) : Boolean 样式类 className 存在于当前元素的 dom 节点中 hide( [Boolean/Object animate] ) : Ext.Element 隐藏当前元素 hover( Function overFn, Function outFn, [Object scope] ) : Ext.Element 设置鼠标移入移出事件 initDD( String group, Object config, Object overrides ) : Ext.dd.DD initDDProxy( String group, Object config, Object overrides ) : Ext.dd.DDProxy initDDTarget( String group, Object config, Object overrides ) : Ext.dd.DDTarget 这个要放到 Ext.dd 去专门搞了,用于拖曳 insertAfter( Mixed el ) : Ext.Element insertBefore( Mixed el ) : Ext.Element insertFirst( Mixed/Object el ) : Ext.Element 在 DOM 中 el 元素之前之后...插入当前元素 insertHtml( String where, String html, Boolean returnEl ) 插入 html 内容 where 可选 beforeBegin, afterBegin, beforeEnd, afterEnd insertSibling( Mixed/Object/Array el, [String where], [Boolean returnDom] ) : 插入或创建 el 做为当前元素的兄弟节点,where 可选 before/after,默认为 before is( String selector ) : Boolean 验证当前节点是否匹配简单选择器 selector isBorderBox()测试不同的样式规则以决定当前元素是否使用一个有边框的盒子 isDisplayed() : Boolean 只要不是指定 display 属性 none 都会返回真 isMasked() : Boolean 仅有当前元素有 mask 并且可见时为真,mask 译为蒙片?就是有些输入框没得到值之前会有一行模糊的提示 的那种东西 isScrollable() : Boolean 可以滚动? isVisible( [Boolean deep] ) : Boolean 可见? last( [String selector], [Boolean returnDom] ) : Ext.Element/HTMLElement 见 first load( String/Function url, [String/Object params], [Function callback], [Boolean discardUrl] ) : Ext.Element 直接 应用当前 updater 的 update 方法 12 mask( [String msg], [String msgCls] ) : Element 为当前对象创建蒙片 move( String direction, Number distance, [Boolean/Object animate] ) : Ext.Element 相前元素相对于当前位置移动, direction 批示方向可能的值是"l","left" - "r","right" - "t","top","up" - "b","bottom","down". distance,指示要移动的距离,以像素为单位 moveTo( Number x, Number y, [Boolean/Object animate] ) : Ext.Element 称动到指定的位置 next( [String selector], [Boolean returnDom] ) : Ext.Element/HTMLElement 下一个符合 selector 的兄弟节点, on( String eventName, Function fn, [Object scope], [Object options] ) : void 详见 addListener position( [String pos], [Number zIndex], [Number x], [Number y] ) : void 初始化当前元素的位置 pos 可选择 relative/absolute/fixed prev( [String selector], [Boolean returnDom] ) : Ext.Element/HTMLElement 前一个符合 selector 的兄弟节点 query( String selector ) : Array 通过样式选择器选择子节点 radioClass( String/Array className ) : Ext.Element 添加样式或样式数组到当前元素,并移除兄弟节点中的指 定样式 relayEvent( String eventName, Object object ) : void 将当前元素的 eventName 事件同时转发给 object 对象 remove() : void 从当前 DOM 中删除元素,并从缓存中移除 removeAllListeners() : Ext.Element 移除所有的侦听者 removeClass( String/Array className ) : Ext.Element 移除样式类 removeListener( String eventName, Function fn ) : Ext.Element 移除事件 eventName 的 fn 侦听器 repaint() : Ext.Element 强制浏览器重绘当前元素 replace( Mixed el ) : Ext.Element 用当前元素替换 el replaceClass( String oldClassName, String newClassName ) : Ext.Element 替换样式类 replaceWith( Mixed/Object el ) : Ext.Element 用 el 替换当前元素 scroll( String direction, Number distance, [Boolean/Object animate] ) : Boolean 滚动,scroll 会保证元素不会越界,direction 和 distance 参数见 move scrollIntoView( [Mixed container], [Boolean hscroll] ) : Ext.Element 滚动到 container 内的视图 scrollTo( String side, Number value, [Boolean/Object animate] ) : Element 基本与 scroll 方法相同,但不保证元素 不越界 select( String selector, [Boolean unique] ) : 与 query 不同的是,通过样式选择器 selector,select 方法会返回一个复合元素对象(CompositeElement)或 CompositeElementLite, set( Object o, [Boolean useSet] ) : Ext.Element 设置属性,例 el.set({width:'200px',height:'200px'}); setBottom( String bottom ) : Ext.Element setLeft( String left ) : Ext.Element setRight( String right ) : Ext.Element setTop( String top ) : Ext.Element setLeftTop( String left, String top ) : Ext.Element 设置 css 对象的属性值 setBounds( Number x, Number y, Number width, Number height, [Boolean/Object animate] ) : Ext.Element 马上改变当前元素的位置和尺寸 setBox( Object box, [Boolean adjust], [Boolean/Object animate] ) : Ext.Element 为当前元素设置一个盒子 box:{x, y, width, height},adjust 指示是否马上调整尺寸 13 setDisplayed( Boolean value ) : Ext.Element 设置可见性 setHeight( Number height, [Boolean/Object animate] ) : Ext.Element setWidth( Number width, [Boolean/Object animate] ) : Ext.Element setSize( Number width, Number height, [Boolean/Object animate] ) : Ext.Element 设置高度和宽度 setLocation( Number x, Number y, [Boolean/Object animate] ) : Ext.Element 设置当前元素相对于页面的横纵 坐标 setOpacity( Float opacity, [Boolean/Object animate] ) : Ext.Element 设置透明度,opacity 为 1 完全不透明,0 完 全透明 setPositioning( Object posCfg ) : Ext.Element 为当前元素指定位置信息,参数 posCfg 参见 getPositioning 说明 setRegion( Ext.lib.Region region, [Boolean/Object animate] ) : Ext.Element 为当前元素指定区域信息 region 定 义 见 getRegion setStyle( String/Object property, [String value] ) : Ext.Element 设置样式 setVisibilityMode( visMode Element.VISIBILITY ) : Ext.Element 指示是使用 Element.VISIBILITY 还是 Element.DISPLAY 属性来定义可见性 setVisible( Boolean visible, [Boolean/Object animate] ) : Ext.Element 设置可见性 setX( Number The, [Boolean/Object animate] ) : Ext.Element setXY( Array pos, [Boolean/Object animate] ) : Ext.Element setY( Number The, [Boolean/Object animate] ) : Ext.Element 设置当前元素相对于 page 的位置 show( [Boolean/Object animate] ) : Ext.Element 显示当前元素 swallowEvent( String eventName, [Boolean preventDefault] ) : Ext.Element 阻止 eventName 事件冒泡,并视 preventDefault 阻断默认行为 toggle( [Boolean/Object animate] ) : Ext.Element 切换元素的 visibility 或 display 属性,依赖于 setVisibilityMode 设定的 toggleClass( String className ) : Ext.Element 如果样式名存在于当前元素对应的 dom 节点,移除,反之应用 translatePoints( Number/Array x, Number y ) : Object 返回一个{left,top}结构 un( String eventName, Function fn ) : Ext.Element 解除事件侦听,参见 removeListener unclip() : Ext.Element 见 clip; unmask() : void 见 mask; unselectable(): Ext.Element 禁止文本选择 up( String selector, [Number/Mixed maxDepth] ) : Ext.Element 通过样式选择器 selector 选择祖先节点 update( String html, [Boolean loadScripts], Function callback ) : Ext.Element 利用 html 更新当前节点内容, loadScripts 指示 html 中如果有 script,是否需要运行,这是一个 innerHTML 的一个老老老问题了 wrap( [Object config], [Boolean returnDom] ) : HTMLElement/Element 用另一个元素 config 包含自己 8、Ext.DomQuery 类 selector 语法详见 Ext 类 compile( String selector, [String type] ) : Function 编写一个选择器或 xpath 查询到一个方法以方便重用,type 取 select(默认)或 simple 值之一 filter( Array el, String selector, Boolean nonMatches ) : Array 过滤 el 中的元素,保留符合 selector 的,如果 nonMatches 为真,结果相反 is( String/HTMLElement/Array el, String selector ) : Boolean 验证 el 是否匹配 selector select( String selector, [Node root] ) : Array 从 root 中选择匹配 selector 的对象数组 selectNode( String selector, [Node root] ) : Element 返回 root 中第一个匹配 selector 的对象 selectNumber( String selector, [Node root], Number defaultValue ) : Number 返回 root 中第一个匹配 selector 的 对象的节点值,转换为整数或浮点数 selectValue( String selector, [Node root], String defaultValue ) : void 返回 root 中第一个匹配 selector 的对象的节 点值,如果为 null,用默认值 defaultValue 代替 14 9、Ext.DomHelper 类 append( Mixed el, Object/String o, [Boolean returnElement] ) : HTMLElement/Ext.Element 创建一个新的 DOM 元素并添加到 el 参数 o 是一个 DOM 对象或一个原始 html 块 applyStyles( String/HTMLElement el, String/Object/Function styles ) : void 应用样式 styles 到对象 el, 样式的 对象表示方法见 Ext.Element createTemplate( Object o ) : Ext.Template 由 o 创建一个新的 Ext.Template 对象,详见 Ext.Template insertAfter( Mixed el, Object o, [Boolean returnElement] ) : HTMLElement/Ext.Element insertBefore( Mixed el, Object/String o, [Boolean returnElement] ) : HTMLElement/Ext.Element 创建一个新的 DOM 对象 o 并将他们挺入在 el 之后/之前 insertFirst( Mixed el, Object/String o, [Boolean returnElement] ) :创建一个新的DOM元素并做为第一个子节点 添加到 el (看了这个 insertFirst,建议将 append 取一个别名 insertLast:)) insertHtml( String where, HTMLElement el, String html ) : HTMLElementwhere 可 选 值 beforeBegin/afterBegin/beforeEnd/afterEnd 将 html 代码插入到 el 附近, markup( Object o ) : String 返回 DOM 对象 o 对应的 html 代码 overwrite( Mixed el, Object/String o, [Boolean returnElement] ) :创建一个新的 DOM 元素 o 并用它重写 el 的内 容 10、Ext.Template 类 Template 类主要是功能是生产 html 片断,例 var t = new Ext.Template( '
', '{name:trim} {value:ellipsis(10)}', '
' ); t.append('some-element', {id: 'myid', cls: 'myclass', name: 'foo', value: 'bar'}); 公用方法: Template( String/Array html )构造一个 Ext.Template 对象,参数可以是字符串形式的 html 代码或它们组成 的数组, Template.from( String/HTMLElement el, Object config ) : Ext.Template 能过 el 的 value(优先)或 innerHTML 来构造模板 append( Mixed el, Object values, [Boolean returnElement] ) : HTMLElement/Ext.Element insertAfter( Mixed el, Object values, [Boolean returnElement] ) : HTMLElement/Ext.Element insertBefore( Mixed el, Object values, [Boolean returnElement] ) : HTMLElement/Ext.Element insertFirst( Mixed el, Object values, [Boolean returnElement] ) : HTMLElement/Ext.Element 这组方法提供由 value 产生的 html 代码,并添加到 dom 做为 el 的最后一个子节点/下一个兄弟节点/前一 个兄弟节点/第一个子节点 values 解释参见 applyTemplate apply() : void applyTemplate( Object values ) : String apply是applyTemplate的简写,如果参数是数字values可以是一个数组,或者一个象 {id: 'myid', cls: 'myclass', name: 'foo', value: 'bar'}这样的 json 对象 compile() : Ext.Template 编译模板,替换掉模板中的\=>\\ ,\r\n|\n==>\\n, '=\',主要是为了 js 自己处理方便 15 overwrite( Mixed el, Object values, [Boolean returnElement] ) :利用 values 生成 html 替换 el 的内容 set( String html, [Boolean compile] ) : Ext.Template 设置模板的 html,如果 compile 为真将调用 compile 方法 11、Ext.EventManager 类 事件管理者中的大部分方法都在 Ext 中有定义,主要用于事件管理 addListener( String/HTMLElement el, String eventName, Function handler, on( String/HTMLElement el, String eventName, Function handler, [Object scope], [Object options] ) : void onDocumentReady( Function fn, [Object scope], [boolean options] ) : void removeListener( String/HTMLElement el, String eventName, Function fn ) : un( String/HTMLElement el, String eventName, Function fn ) : Boolean 参见 Ext onWindowResize( Function fn, Object scope, boolean options ) : void 窗口大小变更时触发 onTextResize( Function fn, Object scope, boolean options ) : void 活动文本尺寸变更时触发 12、Ext.EventObject 类 这两个类都定义在 EventManager.js 中,分开是为了逻辑上更清晰吧,这个类主要用于描述事件本身,一般用 做事件处理方法的参数 另外这个害定义了一些键值常量,比 ascii 码好记 例 function handleClick(e){ // 这儿的 e 就是一个 EventObject 对象 e.preventDefault(); var target = e.getTarget(); ... } var myDiv = Ext.get("myDiv"); myDiv.on("click", handleClick); //or Ext.EventManager.on("myDiv", 'click', handleClick); Ext.EventManager.addListener("myDiv", 'click', handleClick); getCharCode() : Number getKey() : Number 在非 webkit|khtml 类型网页中这两个方法是一样的,得到按键的值 getPageX() : Number getPageY() : Number getXY() : Array 得到事件坐标 getRelatedTarget() : HTMLElement 得到关联目标?我总是得到 null getTarget( [String selector], [Number/Mixed maxDepth], [Boolean returnEl] ) :如果没有定义selector则直接返回 target 属性,如果定义了 selector,则利用 selector 寻找祖先节点 getTime() : Number 得到事件发生的时间? getWheelDelta() : Number 应该是个过时的方法,反正在 ie 和火狐下都不知道做什么用的,原意应该是得到 鼠标的按键信息? hasModifier() : Boolean 事件发生时是否同时按下了 ctrl/alt/shift 键之一? preventDefault() : void 阻止浏览器的默认事件? stopEvent() : voidpreventDefault+stopPropagation stopPropagation() : void 阻止事件冒泡 16 within( Mixed el, [Boolean related] ) : Boolean 如果事件的目标是 el 或者它的子节点将返回真 13、Ext.CompositeElement 类 基础的复合元素类,为容器中每个元素创建一个 Ext.Element 对象 虽然不是继承自 Ext.Element,但事实上它几乎支持 Element 类的所有方法 例: var els = Ext.select("#some-el div.some-class", true); els.setWidth(100); add( String/Array els ) : CompositeElement 添加 css 选择器 els 匹配的元素 或 元素组成的数组 到当前对象 clear() : void 清除所有元素 contains() : Boolean 应该是 contains(Mixed el):Boolean,当前复合元素中是否含有 el each( Function fn, [Object scope] ) : CompositeElement 通过 el,this,index 参数为每个元素调用 fn fill( String/Array els ) : CompositeElementclear()& add(els) filter( String selector ) : CompositeElement 过滤 first() : Ext.Element 第一个元素 getCount() : Number//元素的数量 indexOf() : Boolean 同 contains 一样应该有个 Mixed 参数 item( Number index ) : Ext.Element 第 index 个元素 last() : Ext.Element 最后一个元素 removeElement( Mixed el, [Boolean removeDom] ) : CompositeElement 删除 el 元素 replaceElement( Mixed el, Mixed replacement, [Boolean domReplace] ) : CompositeElement 替换 14、Ext.CompositeElementLite 类 由 Ext.CompositeElement 继承而来,重写了一些方法,但没看出与父类有什么不同 addElements /invoke /item /addListener /each /indexOf /replaceElement 15、Ext.Fx 类 对于我这样的懒鬼而言,Fx 类是核心类库中最激动人心的一个类,它不是最重要的,却是最实用的一个类 定义了一些常用的特效方法,不妨自己多动手试试下面的方法,很有趣的 fadeIn( [Object options] ) : Ext.Element 渐显 options 参数有以下属性 callback:Function 完成后的回叫方法 scope:Object 目标 easing:String 行为方法 默认值是:easeOut,可选值在 ext_base 中找到,但没有说明,以下内容从 yahoo ui 中找到的 easeNone:匀速 easeIn:开始慢且加速 easeOut:开始快且减速 easeBoth:开始慢且减速 easeInStrong:开始慢且加速,t 的四次方 easeOutStrong:开始快且减速,t 的四次方 easeBothStrong:开始慢且减速,t 的四次方 elasticIn: elasticOut: elasticBoth: backIn: 17 backOut: backBoth: bounceIn: bounceOut: bounceBoth: 太多,慢慢体会吧 afterCls:String 事件完成后元素的样式 duration:Number 事件完成时间(以秒为单位) remove:Boolean 事件完成后元素销毁? useDisplay:Boolean 隐藏元素是否使用 display 或 visibility 属性? afterStyle:String/Object/Function 事件完成后应用样式 block:Boolean 块状化? concurrent:Boolean 顺序还是同时执行? stopFx :Boolean 当前效果完成后随合的效果是否将停止和移除 fadeOut( [Object options] ) : Ext.Element 渐隐 fadeOut 和 fadeIn 能使用一个特别的 endOpacity 属性以指示结 束时的透明度 例:el.fadeIn({duration:5,endOpacity:0.7}); frame( [String color], [Number count], [Object options] ) : Ext.Element 边框变亮扩展然后渐隐 例:el.frame("ff0000", 10, { duration: 3 }) ghost( [String anchor], [Object options] ) : Ext.Element 渐渐滑出视图,anchor 定义 tl 左上角(默认) t 上居中 tr 右上角 l 左边界的中央 c 居中 r 右边界的中央 bl 左下角 b 下居中 br 右下角 例: el.ghost('b', { easing: 'easeOut', duration: .5 remove: false, useDisplay: false }); hasActiveFx() : Boolean 指示元素是否当前有特效正在活动 hasFxBlock() : Boolean 是否有特效阻塞了 highlight( [String color], [Object options] ) : Ext.Element 高亮显示当前元素 例:el.highlight("ffff9c", { attr: "background-color", //can be any valid CSS property (attribute) that supports a color value endColor: (current color) or "ffffff", 18 easing: 'easeIn', duration: 1 }); pause( Number seconds ) : Ext.Element 暂停 puff( [Object options] ) : Ext.Element 吹,吹,吹个大气球,元素渐大并隐没 例:el.puff({ easing: 'easeOut', duration: .5, remove: false, useDisplay: false }); scale( Number width, Number height, [Object options] ) : Ext.Element 缩放 例:el.scale( [element's width], [element's height], { easing: 'easeOut', duration: .35 }); sequenceFx()排队特效 shift( Object options ) : Ext.Element 位移,并可重置大小,透明度等 例: el.shift({ width: [element's width], height: [element's height], x: [element's x position], y: [element's y position], opacity: [element's opacity], easing: 'easeOut', duration: .35 }); slideIn( [String anchor], [Object options] ) : Ext.Element slideOut( [String anchor], [Object options] ) : Ext.Element 滑入/滑出 例:el.slideIn('t', { easing: 'easeOut', duration: .5 }); stopFx() : Ext.Element 停止特效 switchOff( [Object options] ) : Ext.Element 收起并隐没 例: el.switchOff({ 19 easing: 'easeIn', duration: .3, remove: false, useDisplay: false }); syncFx() : Ext.Element 异步特效 16、Ext.KeyNav 类 Ext 的 keyNav 类能为 Ext.Element 元素提供简单的按键处理方法 例: var el=Ext.get("textarea"); new Ext.KeyNav(el, { "left" : function(e){ alert("left key down"); }, scope : el } ); 它的行为与 KeyMap 类似,但功能比 KeyMap 要弱小的多,只能处理以下已定义键 enter/left/right/up/down/tab/esc/pageUp/pageDown/del/home/end 同情一下 KeyNav 方法只有三个,不用多解释 KeyNav( Mixed el, Object config ) disable() : void enable() : void 17、Ext.KeyMap 类 则强悍的多,其中最重要的当然是对按键的定义更灵活 例:上例用 KeyMap 来写可能是 var el=Ext.get("textarea"); new Ext.KeyMap(el, { key:Ext.EventObject.LEFT, fn: function(e){ alert("left key down"); }, scope : el } ); 方法 KeyMap( Mixed el, Object config, [String eventName] ) 构造,与 KeyNav 也相似,但更灵活 它是{ key: String/Array, //可以是数字,字符,也可以是 Ext.EventObject.LEFT 这样的助记符,还能是他们组 成的数组 shift: Boolean, //ctrl 键按下? 20 ctrl: Boolean, alt : Boolean, fn : Function, //回叫方法 scope: Object //范围 }这样的对象或它们组成的数组 比如{key: 10},{key: [10,13]},{key:'\t'},{key:'abcd'},{key:Ext.EventObject.LEFT}都是合法的定义 addBinding( Object/Array config ) : void 增加新的绑定动作 config 参见构造 disable() : void enable() : void isEnabled() : Boolean 允许,静止和状态查询 on( Number/Array/Object key, Function fn, [Object scope] ) : void 只添加一个处理时 addBinding 的快捷方式,但个人感觉并没有简单到哪儿去。 18、Ext.util.JSON 类 轮到大名鼎鼎的 JSON 了,可惜 Ext 提供的 JSON 对象功能好弱小,只有 encode 主 decode 两个方法 而且只能编码 String/Array/Date,至少也要搞个 xml2json/json2xml 方法呀 19、Ext.util.Format 类 主要提供了一些格式化方法 capitalize( String value ) : String 首字母大写 date( Mixed value, [String format] ) : String 格式化日期输出,还是 Date.format 方法好用 dateRenderer( String format ) : Function 返回一个利用指定 format 格式化日期的方法 defaultValue( Mixed value, String defaultValue ) : String 如果 value 未定义或为空字符串则返回 defaultValue ellipsis( String value, Number length ) : String 如果 value 的长度超过 length 的,取前 length-3 个并用...替代,对 中国人来说还是垃圾功能,用的字符串长度不是字节长度 fileSize( Number/String size ) : String 简单的格式化文件长度为 xxxbytes xxxKB xxxMB,没有 GB 哟 htmlEncode( String value ) : String htmlDecode( String value ) : String HTML 编码解码,将& < > “替换为&<>" lowercase( String value ) : String 将 value 转换为全小写 stripScripts( Mixed value ) : String 去除脚本标签 stripTags( Mixed value ) : String 去除 HTML 标签 substr( String value, Number start, Number length ) : String 取子字符串 trim( String value ) : String 去除开头和结尾的空格 undef( Mixed value ) : Mixed 如果 value 未定义,返回空字符串,反之返回 value 本身 uppercase( String value ) : String 转为全大写 usMoney( Number/String value ) : String 转为美元表示 20、Ext.util.DelayedTask 类 提供一个 setTimeout 的简单替代方法 公开的方法也只有三个 DelayedTask( [Function fn], [Object scope], [Array args] ) delay( Number delay, [Function newFn], [Object newScope], [Array newArgs] ) : cancel() : void 简单的示例用法如果 21 var task=new Ext.util.DelayedTask(Ext.emptuFn); task.delay(1000); task.cancel(); 21、Ext.util.TaskRunner 类 增强版的 DelayedTask,能提供多线程的定时服务, 例: var task = { run: function(){ Ext.fly('clock').update(new Date().format('g:i:s A')); }, interval: 1000 } var runner = new Ext.util.TaskRunner(); runner.start(task); 四个方法都很简单 TaskRunner( [Number interval] ) start( [Object task] ) : Object stop( Object task ) : Object stopAll() : void 22、Ext.util.TextMetrics 类 这个类主要是为了准备的得到块状化文本正确的高度和宽度 例: var metrics=Ext.util.TextMetrics.createInstance('div'); metrics.setFixedWidth(100); var size=metrics.getSize("中华人民共和国中华人民共和国中华人民共和国中华人民共和国"); Ext.MessageBox.alert("getsize",String.format("width:{0}px\theight:{1}px",size.width,size.height)) 方法 bind( String/HTMLElement el ) : void 绑定到 el createInstance( String/HTMLElement el, [Number fixedWidth] ) : Ext.util.TextMetrics.Instance 为 el 创建 TextMetrics 实例 getHeight( String text ) : Number getSize( String text ) : Object getWidth( String text ) : Number 得到尺寸 measure( String/HTMLElement el, String text, [Number fixedWidth] ) : Object 测算文本 text 在 el 中将要占用的 尺寸 setFixedWidth( Number width ) : void 设置指定的宽度 23、Ext.XTemplate 类 增强型模板,支持更多功能了,虽然方法不多,但用起来来还真的很麻烦,但并不建议大家学习这样的自 定义语法,不如用 xslt 另外这个 Xtemplate 虽然命名空间在 Ext 之下,但源文件却是放在 util 目录中的 XTemplate( String/Array html ) XTemplate.from( String/HTMLElement el ) : Ext.XTemplate 22 apply() : void applyTemplate( Object values ) : String compile() : Function 这些方法 Ext.Template 中都有说明, 24、Ext.data.Connection 类 访问指定的 url,这是个异步调用类,如果想得到服务器信息,请在 request 参数中指定 callback 方法或指定侦听 者(对文件上传无效) Connection( Object config ) 构造,config 定义为{ autoAbort : Boolean, defaultHeaders : Object, disableCaching : Boolean, extraParams : Object, method : String, timeout : Number, url : String } 对象 方法:由 Observable 继承过来的方法省略 abort( [Number transactionId] ) : void 放弃请求,如果同时有多个请求发生,参数指示请求进程序号,不指定则 是放弃最后一个请求 isLoading( [Number transactionId] ) : Boolean 第 transactionId 个请求是否完成载入,未批定指最后一个 request( [Object options] ) : Number 最实用的当然是这个方法了,返回的正是前面的两个方法所需要的进程 id 其中 options 定义为{ url:string, //请求 url params:Object/String/Function, //以 post 方法请求时传递的参数 method:string , //Get/Post callback:Function, //回叫方法,不管是成功还是失败都会呼叫这个方法,有三个参数,由options传入的options 参数,success:Boolean,成功? response:Object, 含有返回数据的 XMLHttpRequest 对象 success:Function, //成功时回叫,第一个参数为 XMLHttpRequest 对象,第二个参数传入指定的 options failure:Function, //失败时回叫,参数同 success scope:Object, //范围 form.:Object/String, //一个 form 对象或它的 id,可以由此自动生成参数 params isUpload:Boolean, //文件上传?通常可以自动检测 headers:Object, //要自定义的请求头信息 xmlData:Object //一个 xml 文档对象,它将通过 url 附加参数的方式发起请求 disableCaching:Boolean //是否禁用缓存?默认为真 } 25、Ext.Ajax 类 由 Ext.data.Connection 继承而来,方法和父类一模一样,但使用起来更简单一些,是一个全局惟一静态类 示例: Ext.Ajax.request({ url: 'foo.php', success: someFn, failure: otherFn, 23 headers: { 'my-header': 'foo' }, params: { foo: 'bar' } }); Ext.Ajax.request({ form. 'some-form', params: 'foo=bar' }); //所有的 Ext.Ajax 请求都会加个这个默认的头 Ext.Ajax.defaultHeaders = { 'Powered-By': 'Ext' }; //所有的 Ext,Ajax 在发起请求前都会调用 showSpinner Ext.Ajax.on('beforerequest', this.showSpinner, this); 26、Ext.data.Record 类 基本上可以理解为.net 中的 datarow 或者 sql server 中的一行数据,它存放了数据的定义信息和他们的值 [公有属性] data : Object 数据内容,一个 json 对象 dirty : Boolean 是否修改过 id : Object 惟一 ID,默认从 1000 开始以 1 剃增 modified : Object 如果记录没有修改过,为 null 如果修改过则存放原始值信息 [公有方法] Record( Array data, [Object id] ) 这个构造方法并不用于创建记录对象,相反,应该使用 create 方法来创建 record 对象,参数 data 定义见 create 方法,id 默认递增起始 id beginEdit() : void 开始修改 cancelEdit() : void 放弃所做的修改,参见 commit copy( [String id] ) : Record//创建当前 record 的一个克隆值,如果未指定 id 使用当前 id+1 commit( [Boolean silent] ) : void commit 方法一般会被 Store 对象调用而不是 recorde 本身,提交自创建或最后 一次修改后的所有变更,如果 silent 为真将不会通知 store 对象 create( [Array o] ) : function 静态构造方法 o 是 config 数组 其中 config 可以含有如下属性 { name : String //字段名 mapping : String //用于 reader 时的映射关系,如果是用于 jsonreader,使用相对当前记录的 javascript 表达式 //,如果是用于 xmlreader,则是相对于记录的 domquery 表达式,对于 ArrayReader,则是序号 type:String //可选值 auto /string/int/float/boolean/date,其中 auto 是默认值,不进行转换 sortType : Mixed //排序类型,Ext.data.SortTypes 成员之一,参见 sortTypes sortDir : String //正序倒序 ASC/DESC 值之一 convert : Function //转换函数,这个功能很有用,可自定义,接收当前 value 返回处理后的 value 24 dateFormat : String //日期格式化字符串,convert:function 的一个特例,使用 Date.parseDate 方法转换当前日 期 } endEdit() : void 结束修改 get( name {String} ) : Object 指定命名字段 string 的值 getChanges() : Object 返回修改记录的对象 reject( [Boolean silent] ) : void 和 commit 相似,当然是拒绝所做的修改 set( String name, Object value ) : void 为字段 name 设定新值 value 27、Ext.data.DataProxy 类 数据代理类是一个纯虚类,主要用于生成 Ext.data.Record 对象,没有公开的属性和方法,只是归定子类需 要处理三个事件 beforeload : ( Object This, Object params ) load : ( Object This, Object o, Object arg ) loadexception : ( Object This, Object o, Object arg, Object e ) 事实上参数也是子类自定义的 28、Ext.data.HttpProxy 类 api 文档中说 httpProxy 是从 object 继 承 来 的 , 事 实 上 source 中 它 和 下 面 的 Ext.data.MemoryProxy/Ext.data.ScriptTagProxy 都继承于 DataProxy HttpProxy 用于远程代理,而且服务端返回信息时必须指定 Content-Type 属性为"text/xml". HttpProxy( Object conn ) 构 造 一个 HttpProxy 对象,参数 可以 是 一个 类似 于{url: 'foo.php'}这样的 json 对象,也 可以 是一 个 Ext.data.Connection 对象,如果参数没有指定,将使用 Ext.Ajax 对象将被用于发起请求 getConnection() : Connection 得到当前连接对象 load( Object params, Ext.data.DataReader reader, Function callback, Object scope, Object arg ) : void 从配置的 connection 对象得到 record 数据块,并激发 callback params: 发起 http 请求时所要传递到服务端的参数 DataReader: 见 DataReader callback: 回叫方法,第一个参数为接收到的信息,第二个参数为 arg,第三个是成功标志 scope: 范围 arg: 这儿的参数将会传递给回叫函数 callback 使用示例: var proxy=new Ext.data.HttpProxy({url:'datasource.xml'}); //关于 reader 将会在 Ext.data.DataReader 中讲解 var reader = new Ext.data.XmlReader({ totalRecords: "results", record: "row", id: "id" }, [ {name: 'name', mapping: 'name'}, {name: 'occupation'} ]); 25 //定义回叫方法 var metadata; function callback(data,arg,success){ if(success){ metadata=data; } } //从 connection 配置的 url 中利用 reader 将返回的 xml 文件转为元数据,并传递给 callback proxy.load( null,reader,callback,this); 29、Ext.data.MemoryProxy 类 MemoryProxy( Object data )构造 load( Object params, Ext.data.DataReader reader, Function callback, Object scope, Object arg ) : void 取数据,和 HttpProxy 类似,只是 params 参数没有被使用 使用示例 var proxy=new Ext.data.MemoryProxy([ [1, 'Bill', 'Gardener'], [2, 'Ben', 'Horticulturalist'] ]); var reader = new Ext.data.ArrayReader( {id: 0}, [ {name: 'name', mapping: 1}, {name: 'occupation', mapping: 2} ]); var metadata; function callback(data,arg,success){ metadata=data; } proxy.load( null,reader,callback,this); 30、Ext.data.ScriptTagProxy 类 这个类和 HttpProxy 类似,也是用于请求远程数据,但能用于跨主域调用,如果请求时使用了 callback 参数 则服务端应指定 Content-Type 属性为"text/javascript" 并返回 callback(jsonobject) 反之则应置 Content-Type 属性为"application/x-json" 并直接返回 json 对象 ScriptTagProxy( Object config ) 构造,其中 config 定义为{ callbackParam : String, //回叫参数 nocache : Boolean, //是否缓存 timeout : Number, //超时 url : String //请求数据的 url } 26 abort() : void 放弃 31、Ext.data.DataReader 类 纯虚类,从数据源得到结构化数据转换为元数据对象,对象包含 Record 的集合,一般用做 Store 对象的元数据, 具有如下格式 { totalRecord:int, records:Array of Ext.data.Record } 具体使用参见三个子类 Ext.data.ArrayReader/Ext.data.JsonReader/Ext.data.XmlReader 方法 DataReader( Object meta, Object recordType )构造 32、Ext.data.ArrayReader 类 用于读数组到一个元数据对象 ArrayReader( Object meta, Object recordType ) 构造,第一个参数是配置除了可以指示使用哪个字段做 id 外,不懂其它的用法, 第二个参数是 recordType 与 record 对象的 create 方法的参数一样,是一样 config 对象数组,具体参见 readRecords( Object o ) : Object 读取 o,返回一个元数据对象 用例示范: //定义数组 var arr=[ [1, 'Bill', 'Gardener'], [2, 'Ben', 'Horticulturalist'] ]; var reader = new Ext.data.ArrayReader( //以第一个元素做为 recordid {id: 0}, //定义数组到 record 的映射关系 [ {name: 'name', mapping: 1}, {name: 'occupation', mapping: 2} ] ); //生成元数据 var data=reader.readRecords(arr); 33、Ext.data.JsonReader 类 用于将一个 json 对象转换为元数据对象 JsonReader( Object meta, Object recordType ) JsonReader 的构造参数 meta 可以有更多选择, { id : String, root : String, successProperty : String, 27 totalProperty : String } 都是对应 json 对象的属性名 read( Object response ) : Object 从一个 response 对象返回,response.responseText 属性应仅含有一个 json 格式 数据块 readRecords( Object o ) : Object 读取 o,返回一个元数据对象 使用示例: var json={ 'results': 2, 'rows': [{ 'id': 1, 'name': 'Bill', occupation: 'Gardener' }, { 'id': 2, 'name': 'Ben', occupation: 'Horticulturalist' } ] }; var reader=new Ext.data.JsonReader( { totalProperty: "results",//totalRecords 属性由 json.results 得到 root: "rows", //构造元数据的数组由 json.rows 得到 id: "id" //id 由 json.id 得到 },[ {name: 'name', mapping: 'name'}, {name: 'occupation'} //如果 name 与 mapping 同名,可以省略 mapping ] ) var data=reader.readRecords(json); 34、Ext.data.XmlReader 类 xmlreader 对象当然是为 xml 而准备的 构造: XmlReader( Object meta, Mixed recordType ) meta 与 jsonreader 类似, meta 是一个{ id : String, record : String, success : String, totalRecords : String }对象,只是这些字符串都是相对于文档根目录的 domquery 路径 read( Object response ) : Object readRecords( Object doc ) : Object .... var str=["", "", "2", "", "1", "Bill", "Gardener", "", "", 28 "2", "Ben", "Horticulturalist", "", ""].join(""); //生成 xmldocument 对象 var xmlDocument; if(Ext.isIE){ xmlDocument = new ActiveXObject("Msxml2.FreeThreadedDOMDocument") xmlDocument.async=false; xmlDocument.resolveExternals = false; xmlDocument.loadXML(str) } else{ xmlDocument = (new DOMParser()).parseFromString(str, "text/xml"); } //然后开始...和其它两个 reader 一样的用法,只是这儿换了一种写法,recordtype 也可以是一个 record 对象 var record = Ext.data.Record.create([ {name: 'name', mapping: 'name'}, // "mapping" property not needed if it's the same as "name" {name: 'occupation'} // This field will use "occupation" as the mapping. ]) var reader = new Ext.data.XmlReader({ totalRecords: "results", record: "row", //row 是节点选择器 id: "id" }, record); var data=reader.readRecords(xmlDocument); 35、Ext.data.Store 类 store 是一个为 Ext 器件提供 record 对象的存储容器,行为和属性都很象数据表 方法:不列举继承来的方法 Store( Object config ) 构造,config 定义为{ autoLoad : Boolean/Object, //自动载入 baseParams : Object, //只有使用 httpproxy 时才有意义 data : Array, //数据 proxy : Ext.data.DataProxy,//数据代理 pruneModifiedRecords : boolean,//清除修改信息 reader : Ext.data.Reader, //数据读取器 remoteSort : boolean, //远程排序? sortInfo : Object, //{field: "fieldName", direction: "ASC|DESC"}这样的排序对象 url : String, //利用 url 构造 HttpProxy } add( Ext.data.Record[] records ) : void 增加记录 records 到 store 29 addSorted( Ext.data.Record record ) : void 增加 record 到 store 并排序(仅本地排序时有用) clearFilter( Boolean suppressEvent ) : void 清除过滤器 collect( String dataIndex, [Boolean allowNull], [Boolean bypassFilter] ) : Array 收集由 dataIndex 指定字段的惟 一值 commitChanges() : void 提交 Store 所有的变更,会引发 Update 事件 filter( String field, String/RegExp value, [Boolean anyMatch], [Boolean caseSensitive] ) : void 设定过滤器 field:String //字段名 value:String //RegExp 如果是字符器,检查 field 是否以 value 开始,如果是正则,检查是否匹配 anyMatch:Boolean //匹配任何部分而不仅令是开始 caseSensitive:Boolean //大小写敏感? filterBy( Function fn, [Object scope] ) : void 更强悍的过滤方法.fn 接收两个参数 record 和 id find( String property, String/RegExp value, [Number startIndex], [Boolean anyMatch], [Boolean caseSensitive] ) : Number 找到符合条件的第一条记录,参数同 filter findBy( Function fn, [Object scope], [Number startIndex] ) : Number 参见 filterBy getAt( Number index ) : Ext.data.Record getById( String id ) : Ext.data.Record 依充号/id 得到 record 对象 getCount() : void 得到记录数 getModifiedRecords() : Ext.data.Record[]得到修改过的记录集 getRange( [Number startIndex], [Number endIndex] ) : Ext.data.Record[]得到指定范围的记录集合 getSortState() : void 得到排序状态:显然不是 void 而是返回一个排序对象,同 sortInfo 一样的结构{field: "fieldName", direction: "ASC|DESC"} getTotalCount() : void 这个对于翻页信息还是很有用的 indexOf( Ext.data.Record record ) : Number indexOfId( String id ) : Number 由记录或 id 得到序号 insert( Number index, Ext.data.Record[] records ) : void 在指定的位置插入记录,并引发 add 事件 isFiltered() : Boolean 当前设置了过滤器则返回真 load( Object options ) : void 由指定的 Proxy 使用指定的 reader 读取远程数据 options 定义为 { params :Object, //请求 url 需要附加的参数 callback :Function//回叫方法,接收三个参数 //r : Ext.data.Record[] //返回的 record 数组 //options: Options load 方法传入的 options //success: Boolean //成功 scope :Object, //范围.默认是 store 本身 add :Boolean 追加还是更新 } loadData( Object data, [Boolean append] ) : void 用法比 load 简单一点,目的是一样的,只是这次数据由本地读 取 query( String field, String/RegExp value, [Boolean anyMatch], [Boolean caseSensitive] ) : MixedCollection queryBy( Function fn, [Object scope] ) : MixedCollection 查询,参数和 find 类似,但返回所有符合条件的 record, 而不是第一个符合条件记录的序号 rejectChanges() : void 放弃所有的变更 reload( [Object options] ) : void 重新载入,相当于 load(options,false),如果连 options 都没有传入,则取最后一次 30 load 时使用的参数 remove( Ext.data.Record record ) : void 移除指定记录 removeAll() : void 移除所有记录 setDefaultSort( String fieldName, [String dir] ) : void 设置默认排序规则 sort( String fieldName, [String dir] ) : void 排序 sum( String property, Number start, Number end ) : Number 对 property 字段由 start 开始到 end 求和 事件列表 add : ( Store this, Ext.data.Record[] records, Number index ) beforeload : ( Store this, Object options ) clear : ( Store this ) datachanged : ( Store this ) load : ( Store this, Ext.data.Record[] records, Object options ) loadexception : () metachange : ( Store this, Object meta. ) remove : ( Store this, Ext.data.Record record, Number index ) update : ( Store this, Ext.data.Record record, String operation ) 看名字都很简单,参数也不复杂,略过 用例 //得到远程 json 对象 //其中 jsoncallback.js 内容为 //{ 'results': 2, 'rows': [ // { 'id': 1, 'name': 'Bill', occupation: 'Gardener' }, // { 'id': 2, 'name': 'Ben', occupation: 'Horticulturalist' } ] //} //定义 proxy var proxy=new Ext.data.HttpProxy(...{url:'jsoncallback.js'}); //定义 reader var reader=new Ext.data.JsonReader( ...{ totalProperty: "results",//totalRecords 属性由 json.results 得到 root: "rows", //构造元数据的数组由 json.rows 得到 id: "id" //id 由 json.id 得到 },[ ...{name: 'name', mapping: 'name'}, ...{name: 'occupation'} //如果 name 与 mapping 同名,可以省略 mapping ] ) //构建 Store var store=new Ext.data.Store(...{ proxy:proxy, reader:reader }); //载入 store.load(); 31 示例 2 //得到远程 xml 文件 //其中 xml 文件内容为 2 1 Bill Gardener 2 Ben Horticulturalist var proxy=new Ext.data.HttpProxy(...{url:'datasource.xml'}); var reader = new Ext.data.XmlReader(...{ totalRecords: "results", record: "row", id: "id" }, [ ...{name: 'name', mapping: 'name'}, ...{name: 'occupation'} ]); var store=new Ext.data.Store(...{ proxy:proxy, reader:reader }); store.load(); 示例 3 //从本地数组得到 var arr=[ [1, 'Bill', 'Gardener'], [2, 'Ben', 'Horticulturalist'] ]; var reader = new Ext.data.ArrayReader( {id: 0}, [ {name: 'name', mapping: 1}, 32 {name: 'occupation', mapping: 2} ]); var store=new Ext.data.Store({ reader:reader }); store.loadData(arr); 36、Ext.data.GroupingStore 类 继承自 Ext.data.Store,为 Store 增加了分组功能.其它用法与 Store 一致,惟一需要注意的是使用 GroupingStore 时必须指定 sortInfo 信息 增加了配置属性 groupField : String//用于分组的字段 groupOnSort : Boolean//如果为真,将依排序字段重新分组,默认为假 remoteGroup : Boolean//远程排序 当然也会多一个 group 方法 groupBy( String field, [Boolean forceRegroup] ) : void 顾名思义都是重新排序用的 下面是个简单的示例 var arr=[ [1, '本', '拉登'], [2, '笨', '拉登'],[3, '笨', '拉灯'] ]; var reader = new Ext.data.ArrayReader( ...{id: 0}, [ ...{name: 'name', mapping: 1}, ...{name: 'occupation', mapping: 2} ]); var store=new Ext.data.GroupingStore(...{ reader:reader, groupField:'name', groupOnSort:true, sortInfo:...{field: 'occupation', direction: "ASC"} //使用 GroupingStore 时必须指定 sortInfo 信息 }); store.loadData(arr); //GridPanel 以后会讨论,这儿使用它是为了直观的表现 GroupingStore var grid = new Ext.grid.GridPanel(...{ ds: store, columns: [ ...{header: "name", width: 20, sortable: true,dataIndex: 'name'}, 33 ...{header: "occupation", width: 20,sortable: true, dataIndex: 'occupation'} ], view: new Ext.grid.GroupingView(...{ forceFit:true, groupTextTpl: '{text} ({[values.rs.length]} {[values.rs.length > 1 ? "Items" : "Item"]})' }), frame.:true, width: 700, height: 450, collapsible: true, animCollapse: false, title: 'Grouping Example', renderTo: 'Div_GridPanel' }); Ext.data.JsonStore 也是 Store 子类,目标是更方便的使用 json 对象做数据源 构造中多了 fields,root,用法如下例所示 /**//* 这是使用远程对象,返回内容与下面本地对象的 data 一致 var store=new Ext.data.JsonStore({ url:'jsoncallback.js', root:'rows', fields:['id','name','occupation'] }); store.load(); */ var store=new Ext.data.JsonStore(...{ data:...{ 'results': 2, 'rows': [ ...{ 'id': 1, 'name': 'Bill', occupation: 'Gardener' }, ...{ 'id': 2, 'name': 'Ben', occupation: 'Horticulturalist' } ]}, autoLoad:true, root:'rows', fields:['id','name','occupation'] }) //目前请先略过 gridpanel,以后再说 var grid = new Ext.grid.GridPanel(...{ ds: store, columns: [ ...{header: "id", width: 200, sortable: true,dataIndex: 'id'}, ...{header: "name", width: 200, sortable: true,dataIndex: 'name'}, ...{header: "occupation", width: 200,sortable: true, dataIndex: 'occupation'} ],height:350, width:620, title:'Array Grid', 34 renderTo: 'Div_GridPanel' }); 37、Ext.data.SimpleStore 类 从数组对象更方便的创建 Store 对象, 例 var store=new Ext.data.JsonStore(...{ data:[ [1, 'Bill', 'Gardener'], [2, 'Ben', 'Horticulturalist'] ], autoLoad:true, fields:[...{name: 'name', mapping: 1},...{name:'occupation',mapping:2}] }) var grid = new Ext.grid.GridPanel(...{ ds: store, columns: [ ...{header: "name", width: 200, sortable: true,dataIndex: 'name'}, ...{header: "occupation", width: 200,sortable: true, dataIndex: 'occupation'} ],height:350, width:620, renderTo: 'Div_GridPanel' }); 38、Ext.data.Tree 类 继承自 Observable,用于存放树装的数据结构 方法 Tree( [Node root] )以 root 为根构造 Ext.data.Tree 对象 getNodeById( String id ) : Node 由指定 id 得到节点 getRootNode() : Node 得到根节点,由属性 root 得到更方便 setRootNode( Node node ) : Node 设置根节点 事件有 append : ( Tree tree, Node parent, Node node, Number index ) beforeappend : ( Tree tree, Node parent, Node node ) beforeinsert : ( Tree tree, Node parent, Node node, Node refNode ) beforemove : ( Tree tree, Node node, Node oldParent, Node newParent, Number index ) beforeremove : ( Tree tree, Node parent, Node node ) insert : ( Tree tree, Node parent, Node node, Node refNode ) move : ( Tree tree, Node node, Node oldParent, Node newParent, Number index ) remove : ( Tree tree, Node parent, Node node ) 39、Ext.data.Node 类 节点 属性 attributes : Object 节点属性集 childNodes : Array 子节点 firstChild : Node 第一个子节点 id : String id 35 lastChild : Node 最后一个子节点 nextSibling : Node 下一个兄弟节点 parentNode : Node 父节点 previousSibling : Node 前一个兄弟节点 Node( Object attributes )构造节点 appendChild( Node/Array node ) : Node 将 node 做为附加在当前节点的 lastChild 之后 bubble( Function fn, [Object scope], [Array args] ) : void 由当前节点开始一直上溯到根节点,对于每个节点应 用 fn,直到有一个 fn 返回假为止 cascade( Function fn, [Object scope], [Array args] ) : void 由当前节点开始一下对每个子孙节点应用 fn.直到返 回 false 为止 contains( Node node ) : Boolean 当前节点是 node 的祖先节点? eachChild( Function fn, [Object scope], [Array args] ) : void 基本同 cascade,但只针对子节点应用 fn findChild( String attribute, Mixed value ) : Node 在子节点中找到第一个有属性 attribute 值为 value 的节点 findChildBy( Function fn, [Object scope] ) : Node 在子节点中找到第一个应用 fn 返回真的节点 getDepth() : Number 得到当前节点深度,根节点深度为 0 getOwnerTree() : Tree 得到当前节点的 Tree 对象 getPath( [String attr] ) : String 得到当前节点的路径,默认 attr 为 id indexOf( Node node ) : Numbernode 在当前节点的子节点中的位置 insertBefore( Node node, Node refNode ) : Node 在参考节点 refNode 之前插入 node 节点 isAncestor( Node node ) : Boolean 当前节点是 node 的祖先节点? isFirst() : Boolean isLast() : Boolean 当前节点是父节点的第一/最后一个节点 isLeaf() : Boolean 是叶节点?指不含子节点 item( Number index ) : Node 第 index 个子节点 removeChild( Node node ) : Node 移除 node 子节点 replaceChild( Node newChild, Node oldChild ) : Node 用 newchild 替换 oldchild 子节点 sort( Function fn, [Object scope] ) : void 用指定的 fn 排序子节点 40、Ext.Action 类 action 实现一个脱离了容 器的事件,所有它可以在多个容器之间共享,不过好象只有 Ext.Toolbar, Ext.Button 和 Ext.menu.Menu 支持 action 接口:),因为容器要实现下面所有的方法 setText(string), setIconCls(string), setDisabled(boolean), setVisible(boolean) and setHandler(function) 方法: Action( Object config ) 构造,config 定义为{ disabled : Boolean,//禁止使用 handler : Function,//事件句柄 hidden : Boolean,//隐藏 iconCls : String,//样式类 scope : Object, //handler 将在哪个范围内执行 text : String //文本 } disable() : void enable() : void setDisabled( Boolean disabled ) : void 禁止/允许 each( Function fn, Object scope ) : void 为每个实现了此 action 的 componet 应用 fn 36 hide() : void show() : void setHidden( Boolean hidden ) : void 显示/隐藏 setHandler( Function fn, Object scope ) : void setIconClass( String cls ) : void setText( String text ) : void 重新设置 config 配置的属性值 示例: function onItemCheck(item){ Ext.MessageBox.alert("点击事件",String.format("您选择了{0}",item.text)); } function showMenu(obj){ Ext.MessageBox.alert("点击下拉",obj.getXTypes() ) } Ext.QuickTips.init(); var button=new Ext.SplitButton({ renderTo:Ext.getBody(), arrowHandler : showMenu, handler: onItemCheck, arrowTooltip : "更多", text:'按我', menu:'mainMenu' }); 41、Ext.Button 类 简单的按钮类 公有属性: disabled : Boolean 允许? hidden : Boolean 隐藏? pressed : Boolean 按下? 方法 [继承来的忽略] Button( Object config ) 构造可选 config{ clickEvent : String, //handler 响应的事件,默认是 click cls : String, //样式 disabled : Boolean, //禁止 enableToggle : Boolean,//允许在按下没按下之间切换,添加移除 x-btn-pressed 样式类 handleMouseEvents : Boolean,//允许使用移入移出按下事件,默认是真 handler : Function, //响应 clickEvent 定义的事件 hidden : Boolean, //隐藏 icon : String, //图标文件地址,如果修改 x-btn-text-icon 样式类可以重定义默认 icon iconCls : String, //和 icon 功能类似,但使用设定了 background-image 属性的样式定义 menu : Mixed //如果需要,可以为按钮定义菜单 menuAlign : String, //菜单对齐方式,默认值是 tl-bl minWidth : Number, //最小宽度 pressed : Boolean, //是否按下 repeat : Boolean/Object,//是否需要重复定义鼠标按下事件,也可以是一个 Ext.util.ClickRepeater 配 37 置对象 scope : Object, //handler 事件的范围 tabIndex : Number, //table 键顺序 text : String, //文本 toggleGroup : String, //如果定义一组 enableToggle 为真且 toggleGroup 值相同的 button 对象, 这些对象同一时间内将只有一个处于按下状态 tooltip : String/Object, //提示信息,可以是一个字符串或 QuickTips 的配置对象 tooltipType : String, //可选值"qtip"(默认)或"title"之一 type : String //可选值"submit"/"reset"/"button"(默认)之一 } focus() : void//得到焦点 getText() : String//取得文本 hasVisibleMenu() : Boolean//有可视的菜单? hideMenu() : void//隐藏菜单 initComponent() : void//初始化容器 setHandler( Function handler, [Object scope] ) : void//设置事件处理方法 setText( String text ) : void//设置文本 showMenu() : void//显示菜单 toggle( [Boolean state] ) : void//切换按下状态 示例: Untitled Page /*--加入样式背景好直观一点*/ .x-btn-pressed button{ background-color:red; } Ext.onReady(function(){ //有菜单的按钮 function onItemCheck(item){ Ext.MessageBox.alert("点击事件",String.format("您选择了{0}",item.text)); } var menu = new Ext.menu.Menu({ id: 'mainMenu', items: [ 38 { text: 'menu1', handler: onItemCheck }, { text: 'menu2', handler: onItemCheck }] }); var button=new Ext.Button({ renderTo:Ext.getBody(), text:'按我', menu:'mainMenu' }); //有状态的探钮 new Ext.Button({ renderTo:Ext.getBody(), text:'toggle button ', enableToggle:true }); //分组的有状态按钮 new Ext.Button({ renderTo:Ext.getBody(), text:'toggle button 1', enableToggle:true, toggleGroup:'toggleGroup', handler: onItemCheck }); new Ext.Button({ renderTo:Ext.getBody(), text:'toggle button 2', enableToggle:true, toggleGroup:'toggleGroup', handler: onItemCheck }); }); 42、Ext.SplitButton 类 上例中的带菜单按钮还不专业,于是有了 Ext.SplitButton,专门为带有下拉菜单的按钮设计的 方法: SplitButton( Object config )构造, 39 config 中加入了{ arrowHandler : Function, arrowTooltip : String } setArrowHandler( Function handler, [Object scope] ) : void 设置下拉箭头的点击事件 事件: arrowclick : ( MenuButton this, EventObject e ) 使用示例: 比如上例中的菜单按钮可以改为 function onItemCheck(item){ Ext.MessageBox.alert("点击事件",String.format("您选择了{0}",item.text)); } function showMenu(obj){ Ext.MessageBox.alert("点击下拉",obj.getXTypes() ) } Ext.QuickTips.init(); var button=new Ext.SplitButton({ renderTo:Ext.getBody(), arrowHandler : showMenu, handler: onItemCheck, arrowTooltip : "更多", text:'按我', menu:'mainMenu' }); 43、Ext.CycleButton 类 这是一个 SplitButton 的实用子类,用于在多个 item 之间切换状态,当然它也会带有 menu 可供选择,也可以 直接点击按键在 item 之间切换 方法: CycleButton( Object config ) 构造,config 新增配置项{ changeHandler : Function, //状态切换时的处理事件 items : Array, //items 应该是 menu item 的数组 prependText : String, //前导 text showText : Boolean, //追加 item 的 text 到按钮显示 } getActiveItem() : Ext.menu.CheckItem setActiveItem( Ext.menu.CheckItem item, Boolean suppressEvent ) : void 得到/设置活动选项 toggleSelected() : void 切换选择项,相当于点击一次按钮 示例 40 new Ext.CycleButton({ renderTo:Ext.getBody(), showText: true, prependText: 'View as ', items: [{ text:'text only', iconCls:'view-text', checked:true },{ text:'HTML', iconCls:'view-html' },{ text:'XML', iconCls:'view-html' } ], changeHandler:function(btn, item){ Ext.MessageBox.alert('Change View', item.text); } }); 44、Ext.form.BasicForm 类 对应一个 dom 中的 form,默认是用 ajax 提交的,如果的确想回传,可以使用如下方式 var myForm. = new Ext.form.BasicForm("form-el-id", { onSubmit: Ext.emptyFn, submit: function() { this.getEl().dom.submit(); } }); 方法: BasicForm( Mixed el, Object config ) 其中 config 配置为 { baseParams : Object, //请求时的附加参数,格式为{id: '123', foo: 'bar'} errorReader : DataReader, //提交时发生验证错误,这个 dataReader 将会被使用 fileUpload : Boolean, //支持文件上传 method : String, //GET 或者 POST reader : DataReader, //load 时使用的数据读取器 timeout : Number, //超时时间 trackResetOnLoad : Boolean,//支持使用 reset 方法恢复原始值 url : String //form 要提交的 url 地址 } add( Field field1, [Field field2], [Field etc] ) : BasicForm 增加字段 field1,field2,etc applyIfToFields( Object values ) : BasicForm applyToFields( Object values ) : BasicForm 用传入的 values 呼叫 Ext.applyIf/apply 方法 41 clearInvalid() : BasicForm 清除当前 basicform 中所有的非法信息 doAction( String/Object actionName, [Object options] ) : BasicForm 执行预定义的动作 actionName,actionName 类似"submit","load",也可以是自定义的动作的名字或一个 Ext.form.Action 的实例,options 类似如下对象{ url :String, method :String, params :String/Object, success :Function, failure :Function, clientValidation :Boolean } findField( String id ) : Field 在当前 form 中查找 id/dataindex/name 等于传入的 id 的 field 对象 getEl() : Ext.Element 得到当前 form 对象的 element 对象 getValues( Boolean asString ) : Object 得到当前 form 的 fields {name:value,name:values}json 对象,如果有同名 多值,value 将是一个数组 isDirty() : Boolean 从初始载入后,是否有 field 被修改过 isValid() : Boolean 客户端验证成功? load( Object options ) : BasicForm 等效于 doAction('load',options); loadRecord( Record record ) : BasicForm 从一个 record 对象取值到当前 basicform markInvalid( Array/Object errors ) : BasicForm 标志非法,[{id:'fieldId', msg:'The message'},...]这样格式的数组 或者{id: msg, id2: msg2}格式的对象 remove( Field field ) : BasicForm 从 basicform 中移除 field render() : BasicForm 在 basicForm 的 fields 中寻找,利用 id 属性检查他们,然后用 id 属性呼叫 applyTo 方法 reset() : BasicForm 重置所有值 setValues( Array/Object values ) : BasicForm 设置值,参见 getValues submit( Object options ) : BasicForm 提交表单 updateRecord( Record record ) : BasicForm 利用当前更新 record 对象,参见 loadRecord 事件: actioncomplete : ( Form. this, Action action ) actionfailed : ( Form. this, Action action ) beforeaction : ( Form. this, Action action ) 45、Ext.form.Field 类 有了 form 之后,我们当然还需要 field 方法: Field( Object config ) 其中 config 设置为{ autoCreate : String/Object, //一个{tag: "input", type: "text", size: "20", autocomplete: "off"}这样的对象,或 者选 择 true,就是前面所说的那个固定内置对象 clearCls : String, //,默认 x-form-clear-left cls : String, //默认样式 disabled : Boolean, fieldClass : String //x-form-field fieldLabel : String focusClass : String //x-form-focus 42 hideLabel : Boolean //隐藏前导标签 inputType : String //input type="???" invalidClass : String //x-form-invalid invalidText : String itemCls :String labelSeparator : String //分隔符 msgFx : String msgTarget : String name : String readOnly : Boolean tabIndex : Number validateOnBlur : Boolean //true validationDelay : Number //250 validationEvent : String/Boolean //KeyUP value : Mixed } 构造很麻烦的,但还好我们一般不会直接使用 field clearInvalid() : void 清除非法信息 getName() : String getRawValue() : Mixed getValue() : Mixed isDirty() : void isValid( Boolean preventMark ) : Boolean markInvalid( String msg ) : void reset() : void setRawValue( Mixed value ) : void setValue( Mixed value ) : void validate() : Boolean 都很简单也略过了 事件 blur : ( Ext.form.Field this ) change : ( Ext.form.Field this, Mixed newValue, Mixed oldValue ) focus : ( Ext.form.Field this ) invalid : ( Ext.form.Field this, String msg ) specialkey : ( Ext.form.Field this, Ext.EventObject e ) valid : ( Ext.form.Field this ) 46、Ext.form.Checkbox 类 继承自 Field, 复选框 Checkbox( Object config ) 构造,其中 config{ autoCreate : String/Object, boxLabel : String, 43 checked : Boolean, fieldClass : String,//x-form-field focusClass : String, } getValue() : Boolean initComponent() : void setValue( Boolean/String checked ) : void 事件 check : ( Ext.form.Checkbox this, Boolean checked ) 47、Ext.form.Radio 类 继承自 Ext.form.Checkbox,单选框 多了一个方法 getGroupValue() : String 如果单选框是一组 radio 的一部分,取当前选中的值 Ext.form.Hidden 继承自 Field,隐藏字段,无新特性 48、Ext.form.HtmlEditor 类 继承自 Field,这个 htmleditor 功能太简单了,什么人能扩充一下就好了 config 定义{ createLinkText : String // defaultLinkValue : String // http:// enableAlignments : Boolean enableColors : Boolean enableFont : Boolean enableFontSize : Boolean enableFormat : Boolean enableLinks : Boolean enableLists : Boolean enableSourceEdit : Boolean fontFamilies : Array //这个当然要用汉字的字体组成的数组了 } 方法 cleanHtml( String html ) : void createToolbar( HtmlEditor editor ) : void execCmd( String cmd, [String/Boolean value] ) : void getDocMarkup() : void getToolbar() : Ext.Toolbar insertAtCursor( String text ) : void pushValue() : void relayCmd( String cmd, [String/Boolean value] ) : void syncValue() : void toggleSourceEdit( [Boolean sourceEdit] ) : void updateToolbar() : void 要提一点的是,要使用 HtmlEditor,别忘了先 Ext.QuickTips.init(); 44 49、Ext.form.TextField 类 config{ allowBlank : Boolean //允许为空 blankText : String //如果为空验证错误时的提示文字 ,默认 This field is required disableKeyFilter : Boolean emptyClass : String emptyText : String grow : Boolean // 自动生长?,如果需要,会加宽当前 input type="text" growMax : Number growMin : Number maskRe : RegExp //仅允许输入与 maskRe 匹配的按键 maxLength : Number maxLengthText : String //超出最大长度时提示文本 minLength : Number minLengthText : String //不够最小长度时提示信息 regex : RegExp //正则匹配 regexText : String //提示 selectOnFocus : Boolean validator : Function //自定义验证方法,接受当前字段的值,如果合法,返回真,反之返回自定义信息 vtype : String //Ext.form.VTypes 中定义的 vtype 类型名,支持简单的类型验证 vtypeText : String//如果不是,则提示 } 方法: TextField( Object config )构造 autoSize() : void 自动尺寸 reset() : void 重置 selectText( [Number start], [Number end] ) : void 选择文本 validateValue( Mixed value ) : Boolean 验证值 50、Ext.form.NumberField 类 继承自 Ext.form.TextField,因为 Ext.form.TextField 虽然强大,但写起来的确还是有点麻烦,后面的类都 继承自 Ext.form.TextField,没有自定义的方法,属性和事件 config 定义为{ allowDecimals : Boolean //true allowNegative : Boolean //true baseChars : String //'0123456789' decimalPrecision : Number //精度,默认值 2 decimalSeparator : String //小数分隔符 fieldClass : String //默认样式为 x-form-field x-form-num-field maxText : String maxValue : Number //默认 Number.MAX_VALUE minText : String minValue : Number //默认 Number.NEGATIVE_INFINITY nanText : String //NaN 时显示? 45 } 51、Ext.form.TextArea 类 config{ autoCreate : String/Object //{tag: "textarea", style. "width:100px;height:60px;", autocomplete: "off"} growMax : Number //1000 growMin : Number //60 preventScrollbars : Boolean //如果为真等于设置 overflow: hidden,默认为 false } 52、Ext.form.TriggerField 类 这个类只要 text 旁边加了个下拉按钮,要自己实现 onTriggerClick config{ autoCreate : String/Object, //{tag: "input", type: "text", size: "16", autocomplete: "off"} hideTrigger : Boolean //隐藏 trigger,就是右边的那个下拉选择框 triggerClass : String } 事件 onTriggerClick( EventObject e ) : void 53、Ext.form.DateField 类 继承自 TriggerField,用于日期选择 config{ altFormats : String //转换用户输入到日期时的格式,默认 'm/d/Y|m-d-y|m-d-Y|m/d|m-d|d' autoCreate : String/Object //{tag: "input", type: "text", size: "10", autocomplete: "off"} disabledDates : Array //禁止选择的日期:例 ["^03","04/../2006","09/16/2003"],不让选 3 月,2006 年 4 月,2003 年 9 月 16 disabledDatesText : String //不让选总得给个理由吧 disabledDays : Array //不让选星期几,例[0,6],不让选周六,周日 disabledDaysText : String //周日要休息,这就是理由 format : String //显示时的格式 invalidText : String //验证非法时的提示 maxText : String maxValue : Date/String minText : String minValue : Date/String triggerClass : String } 方法,除了构造,多了两个顾名思义的方法 DateField( Object config ) getValue() : Date 46 setValue( String/Date date ) : void 54、Ext.form.ComboBox 类 config{ allQuery : String //'' autoCreate : Boolean/Object //{tag: "input", type: "text", size: "24", autocomplete: "off"} displayField : String //显示字段 editable : Boolean //true 当然就是 combobox 了,如果不可编辑就是一个 select 了 forceSelection : Boolean handleHeight : Number //如果 resiable 为真时,设置 hiddenName : String lazyInit : Boolean //除非得到焦点才开始初始化列表,默认为真 lazyRender : Boolean //除非请求,才开始输出,默认为假 listAlign : String //对齐方式,参见 Ext.Element.alignTo,默认为'tl-bl' listClass : String listWidth : Number loadingText : String //仅当 mode = 'remote'时调用数据时显示的文本 maxHeight : Number //300 minChars : Number //最少输入多少个字开始响应,远程时默认为 4,本地为 0,如果 不可编辑则此值无效 minListWidth : Number mode : String //可选值 local/remote 之一,从本地还是远程取数据 pageSize : Number //在远程模式下,如果此值大于 0 会在底部显示一个翻页工具条 queryDelay : Number //查询延时,远程默认为 500,本地 10 queryParam : String //查询参数,默认为 query resizable : Boolean selectOnFocus : Boolean selectedClass : String shadow : Boolean/String //True 或"sides"为默认风格, "frame" for 4-way shadow, and "drop" for bottom-right store : Ext.data.Store title : String transform. Mixed //对应一个 select 元素,可以将 select 转为 combobox 对象 triggerAction : String //点击按钮时的动作.默认为 query triggerClass : String typeAhead : Boolean //false typeAheadDelay : Number //250 valueField : String valueNotFoundText : String //值不存在时的提示信息 } 属性 view : Ext.DataView 方法 47 ComboBox( Object config )构造 clearValue() : void 清除所有文本/值对 collapse() : void expand() : void 收起/展开下拉列表 doQuery( String query, Boolean forceAll ) : void 执行查询 getValue() : String 选择当前字段的值 isExpanded() : void 下拉列表是展开的? select( Number index, Boolean scrollIntoView ) : void 选中第 index 列表项 selectByValue( String value, Boolean scrollIntoView ) : Boolean 选中值为 value 的列表项 setEditable( Boolean value ) : void 设 editable 属性为 value setValue( String value ) : void 设置当前值为 事件 beforequery : ( Object queryEvent ) beforeselect : ( Ext.form.ComboBox combo, Ext.data.Record record, Number index ) collapse : ( Ext.form.ComboBox combo ) expand : ( Ext.form.ComboBox combo ) select : ( Ext.form.ComboBox combo, Ext.data.Record record, Number index ) 55、Ext.form.TimeField 类 继承自 combobox,用于选择时间 config{ altFormats : String // format : String increment : Number //时间增长间隔,默认 15 invalidText : String maxText : String maxValue : Date/String minText : String minValue : Date/String } 总 的来说 Ext.form 对 input type='text' select 这样的输入标签都有对应的类,并对有些标签做了简单 的扩展,当然很重要的一点,漂亮多了,vtype 属性也方便了处理,建议有兴趣的同胞对 Ext.form.VTypes 和 Ext.form.HtmlEditor 做一些扩展 form 中还有两个类,比如下例中的 FormPanel 和 FieldSet, 都继承自 panel,所以会放在 panel 中解释 综合示例 Ext.QuickTips.init(); var arr=[ [1, '本.拉登'], [2, '笨.拉登'],[3, '笨.拉灯'] ]; var reader = new Ext.data.ArrayReader( {id: 0}, [ {name: 'value'}, {name: 'key'} 48 ]); var store=new Ext.data.Store({ reader:reader }); store.loadData(arr); var htmleditor=new Ext.form.HtmlEditor({ fieldLabel:'htmleditor', width:450, fontFamilies:['宋体','隶书'], name:'editor', id:'editor' }); var form. = new Ext.FormPanel({ labelWidth: 75, url:'post.php', frame.:true, width: 800, defaultType: 'textfield', items: [ new Ext.form.Checkbox({ //checkbox fieldLabel:'checkbox', name:'cb', checked:true, boxLabel:'checkbox' }), new Ext.form.FieldSet({ //radio border:false, title:'radio', items:[ new Ext.form.Radio({ labelSeparator:'', name:'radio', checked:true, boxLabel:'radio 1' }), new Ext.form.Radio({ labelSeparator:'', name:'radio', checked:true, boxLabel:'radio 2' }) ] }), new Ext.form.Hidden({ //hidden name:'hidden' 49 }), htmleditor, new Ext.form.TextField({ //text fieldLabel:'text', name:'text', grow:true, allowBlank:false, blankText : "这个字段最好不要为空", maskRe:/[a-zA-z]/gi }), new Ext.form.NumberField({ //NumberField allowNegative:true, fieldLabel:'number', name:'number' }), new Ext.form.TextArea({ //TextArea fieldLabel:'textarea', name:'textarea' }), new Ext.form.TriggerField({ //TriggerField fieldLabel:'TriggerField', name:'TriggerField' }), new Ext.form.ComboBox({ //select fieldLabel:'select', editable:false, triggerAction: 'all', valueField:'value', displayField:'key', mode: 'local', store:store }), new Ext.form.ComboBox({ //combobox fieldLabel:'ComboBox', displayField:'key', mode: 'local', store:store }), new Ext.form.DateField({ //DateField fieldLabel:'DateField', format:'Y-m-d', disabledDays:[0,6] }), new Ext.form.TimeField({//TimeField fieldLabel:'TimeField', mode: 'local', 50 increment:60 }) ] }); form.render(document.body); htmleditor.setRawValue("

hello world

"); htmleditor.syncValue(); 56、Ext.menu.Menu 类 菜单对象 config{ allowOtherMenus : Boolean //允许同时显示其它的菜单? defaultAlign : String //默认对齐方式:tl-bl? defaults : Object //默认的菜单项配置,将会应用到所有的 items items : Mixed //菜单项数组 minWidth : Number //最小宽度.默认 120 shadow : Boolean/String // subMenuAlign : String //子菜单对齐方式 tl-tr? } Menu( Object config )构造 add( Mixed args ) : Ext.menu.Item 添加菜单项 可能的参数为 * 从 Ext.menu.Item 继承来的菜单项对象 * 可以被转换为 menu item 的 HTMLElement 对象 * 一个 Ext.menu.Item 的构造 config 对象 *一个字符串,-或 separator 将为分隔项,其它的做为 TextItem 对象的构造参数 addElement( Mixed el ) : Ext.menu.Item 添加 Element 对象 addItem( Ext.menu.Item item ) : Ext.menu.Item 添加 Item 对象 addMenuItem( Object config ) : Ext.menu.Item 添加 Item 对象,这回传入的参数是 item 构造的 config 参数 addSeparator() : Ext.menu.Item 添加间隔项 addText( String text ) : Ext.menu.Item 添加文本项 getEl() : Ext.Element 得到当前 element 对象 hide( [Boolean deep] ) : void 隐藏 insert( Number index, Ext.menu.Item item ) : Ext.menu.Item 在 index 位置插入 item isVisible() : void 可见? remove( Ext.menu.Item item ) : void 移除 item removeAll() : void 移除所有 show( Mixed element, [String position], [Ext.menu.Menu parentMenu] ) : void 相对于 element 显 示当前菜单 showAt( Array xyPosition, [Ext.menu.Menu parentMenu] ) : void 在绝对位置 xyposition 显示当前菜 单 57、Ext.menu.BaseItem 类 51 所有菜单项的基类,继承自 Component config { activeClass : String //活跃时的样式类,默认 x-menu-item-active canActivate : Boolean //能设置活跃?默认为 false handler : Function //事件处理句柄 hideDelay : Number //隔多长时间自动隐藏,默认 100(毫秒) hideOnClick : Boolean //点击后自动隐藏,默认为真 } BaseItem( Object config )构造 setHandler( Function handler, Object scope ) : void 设置处理句柄 handler 事件: activate : ( Ext.menu.BaseItem this ) click : ( Ext.menu.BaseItem this, Ext.EventObject e ) deactivate : ( Ext.menu.BaseItem this ) 58、Ext.menu.Adapter 类 这个类是为了支持将非 BaseItem 子类的容器转换为支持 baseitem 的适配器,除了构造,与 BaseItem 无异 Adapter( Ext.Component component, Object config ),可以自己再继承它做点实用的事, 他的两个子类 更好用 Ext.menu.ColorMenu 提供颜色选择 Ext.menu.DateItem 提供日期选择 59、Ext.menu.Item 类 是 BaseItem 的另一个实用子类,提供一般的菜单项,支持菜单项之间的相互关系 config{ canActivate : Boolean href : String hrefTarget : String icon : String //默认 Ext.BLANK_IMAGE_URL,建议更改,extjs.com 的确太慢了 iconCls : String itemCls : String showDelay : Number text : String } 方法 Item( Object config ) 构造 setIconClass( String cls ) : void setText( String text ) : void 60、Ext.menu.CheckItem 类 继承自 Item,前面带有选择框的菜单项 config{ checked : Boolean 52 group : String groupClass : String //默认 x-menu-group-item itemCls : String } 方法 CheckItem( Object config )构造 checkHandler( Ext.menu.CheckItem this, Boolean checked ) : void 选择处理方法 setChecked( Boolean checked, [Boolean suppressEvent] ) : void 设置选择状态 事件 beforecheckchange : ( Ext.menu.CheckItem this, Boolean checked ) checkchange : ( Ext.menu.CheckItem this, Boolean checked ) 61、Ext.menu.Separator 类 继承自 item,间隔项 62、Ext.menu.TextItem 类 继承自 item,文本项 config{ hideOnClick : Boolean itemCls : String text : String } 下面的示例从 ext 官方而来,继续简单的修改,只有 menu 相关部分.同样也都很简单 Ext.QuickTips.init(); //日期选择项点击事件 var dateMenu = new Ext.menu.DateMenu({ handler : function(dp, date){ Ext.MessageBox.alert('Date Selected', String.format('You chose {0}.', date.format('M j, Y'))); } }); var colorMenu = new Ext.menu.ColorMenu({ handler : function(cm,color){ Ext.MessageBox.alert('Color Selected', String.format('You chose #{0}.', cm.palette.value)); } }); var menu = new Ext.menu.Menu({ id: 'mainMenu', 53 items: [ { text: 'I like Ext', checked: true, checkHandler: onItemCheck }, { text: 'Ext for jQuery', checked: true, checkHandler: onItemCheck }, { text: 'I donated!', checked:false, checkHandler: onItemCheck }, '-', { text: 'Radio Options', menu: { items: [ 'Choose a Theme', { text: 'Aero Glass', checked: true, group: 'theme', checkHandler: onItemCheck }, { text: 'Vista Black', checked: false, group: 'theme', checkHandler: onItemCheck }, { text: 'Gray Theme', checked: false, group: 'theme', checkHandler: onItemCheck }, { text: 'Default Theme', checked: false, group: 'theme', checkHandler: onItemCheck } ] } },{ text: 'Choose a Date', iconCls: 'calendar', menu: dateMenu 54 },{ text: 'Choose a Color', menu: colorMenu } ] }); var tb = new Ext.Toolbar(); tb.render(Ext.getBody()); tb.add({ text:'Button w/ Menu', iconCls: 'bmenu', // <-- icon menu: menu // assign menu by instance } ); menu.addSeparator(); // Menus have a rich api for // adding and removing elements dynamically var item = menu.add({ text: 'Dynamically added Item' }); // items support full Observable API item.on('click', onItemClick); // items can easily be looked up menu.add({ text: 'Disabled Item', id: 'disableMe' // <-- Items can also have an id for easy lookup // disabled: true <-- allowed but for sake of example we use long way below }); // access items by id or index menu.items.get('disableMe').disable(); //这个增加子菜单的方法照猫画虎学的,至于add的到底是个什么?getXType得不到,item有私有的 属性 menu? var ele=menu.add({ text:'submit', menu:{ items:[ {text:'submenu1',handler:onItemClick}, {text:'submenu2',handler:onItemClick} ] } }); 55 // functions to display feedback function onButtonClick(btn){ Ext.MessageBox.alert('Button Click',String.format('You clicked the "{0}" button.', btn.text)); } function onItemClick(item){ Ext.MessageBox.alert('Menu Click', String.format('You clicked the "{0}" menu item.', item.text)); } function onItemCheck(item, checked){ Ext.MessageBox.alert('Item Check', String.format('You {1} the "{0}" menu item.', item.text, checked ? 'checked' : 'unchecked')); } function onItemToggle(item, pressed){ Ext.MessageBox.alert('Button Toggled', String.format('Button "{0}" was toggled to {1}.', item.text, pressed)); } 63、Ext.Toolbar 类 工具栏,使用起来很简单,add 已准备好的元素就行 方法 Toolbar( Object/Array config )构造 add( Mixed arg1, Mixed arg2, Mixed etc. ) : void 增加元素 可以是 1:Ext.Toolbar.Button 相当于 addButton 2:HtmlElement 相当于 addElement 3:Field 相当于 addField 4:Item 相当于 addItem 5:String 相当于 addText 6:'separator'或'-' 相当于 addSeparator 7:'' 相当于 addSpacer 8:'->' 相当于 addFill addButton( Object/Array config ) : Ext.Toolbar.Button/Array 添加 Ext.Toolbar.Button/SplitButton 对象,其实因为 Ext.Toolbar.Button 和 Ext.Button 用起来没什么 区别,而且 Toolbar 两者都支持,我实验时没发现使用上有什么不同 addDom( Object config ) : Ext.Toolbar.Item 添加 DOM 节点 addElement( Mixed el ) : Ext.Toolbar.Item 添加 Element 对象 addField( Ext.form.Field field ) : Ext.ToolbarItem 添加 Ext.form.Field 对象 addFill() : Ext.Toolbar.Fill 添加一个撑满工具条的空白元素 addItem( Ext.Toolbar.Item item ) : Ext.Toolbar.Item 添回 Ext.Toolbar.Item 对象 addSeparator() : Ext.Toolbar.Item添加一个分隔元素,相当于addItem(new Ext.Toolbar.Separator()); addSpacer() : Ext.Toolbar.Spacer 添加一个空白元素,相当于 addItem(new Ext.Toolbar.Spacer()); 56 addText( String text ) : Ext.Toolbar.Item 添加文本元素,相当于 addItem(new Ext.Toolbar.TextItem(text)); insertButton( Number index, Object/Ext.Toolbar.Item/Ext.Toolbar.Button button ) : Ext.Toolbar.Button/Item 在第 index 个元素之前插入 button 对象 64、Ext.Toolbar.Item 类 工具栏元素基类 Toolbar.Item( HTMLElement el )构造 destroy() : void 销毁 disable() : void enable() : void 可用/禁用 focus() : void 得到焦点 getEl() : HTMLElement 得到当前 DOM 对象 setVisible( Boolean visible ) : void show() : void hide() : void 显示隐藏 65、Ext.Toolbar.Separator 类 继承自 item,工具栏分隔符 66、Ext.Toolbar.Spacer 类 继承自 item,工具栏空白元素 67、Ext.Toolbar.TextItem 类 继承自 item,工具栏文本元素 68、Ext.Toolbar.Fill 类 继承自 Spacer,工具栏空白元素,撑满工具栏 简单的示例 var tb = new Ext.Toolbar({width:400}); //在 add 之前先 render,必要,不然会报错//在 add 之前先 render,必要 tb.render(Ext.getBody()); tb.addText('请选择时间'); tb.add( new Ext.form.DateField({ //DateField fieldLabel:'DateField', format:'Y-m-d', disabledDays:[0,6] }) ); tb.addButton( 57 new Ext.Toolbar.Button({ text:'button', handler:function(item){ Ext.MessageBox.alert("toolbar","您点击了"+item.text) } }) ); tb.addSpacer(); tb.addSeparator(); tb.addFill(); tb.add(new Ext.SplitButton({ handler: function(item){ Ext.MessageBox.alert("点击事件",String.format("您选择了 {0}",item.text)); }, arrowTooltip : "更多", text:'按我', menu:new Ext.menu.Menu({ id: 'mainMenu', items: [ { text: '菜单项 1' }, 58 { text: '菜单项 2' }] }) }) ); 69、Ext.grid.ColumnModel 类 用于定义 Grid 的列 用例 var colModel = new Ext.grid.ColumnModel([ {header: "Ticker", width: 60, sortable: true}, {header: "Company Name", width: 150, sortable: true} ]); 回到 ColumnModel,它的构造参数是一个 config 组成的数组,其中 config 定义为{ align : String //css 中的对齐方式 dataIndex : String //要绑定的 Store 之 Record 字段名 fixed : Boolean //如果为真列宽不能被改变 header : String //头部显示的名称 hidden : Boolean //隐藏本列 id : String //主要用于样式选择,如果已定义此属性,那么列所在的单元格会定义 class 为 x-grid-td-id renderer : Function //可以使用这个构造参数格式化数据 resizable : Boolean //可调节尺寸 sortable : Boolean // 可排序 width : Number //宽度 } 另 外虽然未经声明,但 config 事实上支持 editor:Ext.form.Field 属性,这点会在 Ext.grid.EditorGridPanel 中看到,另外为了扩展 grid 的表现,我们通常也需要自定义列,顺便提一个有 趣的列,Ext.grid.RowNumberer,这是 Ext 为我们扩展好 的一个简单列,它的构造很简单,也没有其它的方 法和属性,Ext.grid.RowNumberer({ header : String, sortable : Boolean, width : Number})如果使用 它,上例可改为 var colModel = new Ext.grid.ColumnModel([ new Ext.grid.RowNumberer(), {header: "Ticker", width: 60, sortable: true}, {header: "Company Name", width: 150, sortable: true} ]); 属性 defaultSortable : Boolean //默认可排序 defaultWidth : Number //默认的宽度 59 setConfig : Object //返回构造时的 config 参数 方法 ColumnModel( Object config ) 构造 getCellEditor( Number colIndex, Number rowIndex ) : Object 得到指定行列的编辑者 getColumnById( String id ) : Object 得到指定 id 的列对象 getColumnCount() : Number 得到列数 getColumnHeader( Number col ) : String 得到列头部文本 getColumnId( Number index ) : String 得到列 id getColumnTooltip( Number col ) : String 得到列提示 getColumnWidth( Number col ) : Number 列宽 getColumnsBy( Function fn, [Object scope] ) : Array 通过 fn 找到指定的列 getDataIndex( Number col ) : Number 得到指定列的数据绑定对象在 store 中的序号 getIndexById( String id ) : Number 通过 id 找序号 getRenderer( Number col ) : Function 得到绘制器 getTotalWidth( Boolean includeHidden ) : Number 总的宽度 hasListener( String eventName ) : Boolean 有事件侦听者? isCellEditable( Number colIndex, Number rowIndex ) : Boolean 指定行列可编辑? isFixed() : void 应该返回 Boolean,充满? isHidden( Number colIndex ) : Boolean 指定列隐藏? isResizable() : Boolean 可重写义大小 isSortable( Number col ) : Boolean 可排序? setColumnHeader( Number col, String header ) : void 设置指定列列头 setColumnTooltip( Number col, String tooltip ) : void 设置指定列提示 setColumnWidth( Number col, Number width ) : void 设置指定列宽度 setConfig( Array config ) : void 重设 config setDataIndex( Number col, Number dataIndex ) : void 设置指定列的数据源 setEditable( Number col, Boolean editable ) : void 设置指定列是否可编辑 setEditor( Number col, Object editor ) : void 为指定列设置编辑器 setHidden( Number colIndex, Boolean hidden ) : void 设置指定列隐藏 setRenderer( Number col, Function fn ) : void 为指定列设置输出方法 事件 columnmoved : ( ColumnModel this, Number oldIndex, Number newIndex ) configchanged : ( ColumnModel this ) headerchange : ( ColumnModel this, Number columnIndex, String newText ) hiddenchange : ( ColumnModel this, Number columnIndex, Boolean hidden ) widthchange : ( ColumnModel this, Number columnIndex, Number newWidth ) 70、Ext.grid.PropertyColumnModel 类 继承自 Ext.grid.ColumnModel,专为 Ext.grid.PropertyGrid 而设计,构造有点不同,不过这个 api 文档不 知道谁写的,ext2 中好象没有 grid 了, PropertyColumnModel( Ext.grid.Grid grid, Object source ) 71、Ext.grid.GridView 类 为 GridPanel 提供视图支持 config{ 60 autoFill : Boolean enableRowBody : Boolean forceFit : Boolean } 属性 columnsText : String //列文本 scrollOffset : Number //滚动步行 sortAscText : String //正序文本 sortClasses : Array //正序和倒序时头部列使用的样式,默认为["sort-asc", "sort-desc"] sortDescText : String //倒序文本 方法 GridView( Object config )构造 focusCell( Number row, Number col ) : void 指定第 row 行第 col 列得到焦点 focusRow( Number row ) : void 选中第 row 行 getCell( Number row, Number col ) : HtmlElement 得到指定行列的 htmlelement 对象 getHeaderCell( Number index ) : HtmlElement 得到指定列的表单头对象 getRow( Number index ) : HtmlElement 得到指定行的 htmlelement 对象 getRowClass( Record record, Number index, Object rowParams, Store ds ) : void//得到指定行的样 式?郁闷的是没有能在 GridView.js 中找到此方法的定义 refresh( [Boolean headersToo] ) : void 涮新显示 scrollToTop() : void 滚动到头部 72、Ext.grid.GroupingView 类 继承自 Ext.grid.GridView,用于数据分组 ,应用于 config{ emptyGroupText : String //空的分组显示文本 enableGroupingMenu : Boolean //允许分组菜单 enableNoGroups : Boolean //允许分组/不分组显示 groupTextTpl : String //这是个模板,分组项的内容依此显示,语法参见模板, hideGroupedColumn : Boolean //隐藏分组列 startCollapsed : Boolean //开始时收起,默认为假 } 另外虽然没有在 api 中说明,但 groupByText 和 showGroupsText 属性也是可以在 config 中指定的 方法 GroupingView( Object config )构造 getGroupId( String value ) : void 取得指定值的分组 id,为 toggleGroup 而准备的方法 toggleAllGroups( [Boolean expanded] ) : void 收起或展开所有的分组 toggleGroup( String groupId, [Boolean expanded] ) : void 展开或收起指定的分组,例 grid.view.toggleGroup(grid.view.getGroupId('Horticulturalist'));会展开或收起分组字段值为 'Horticulturalist'的分组 Ext.onReady(function(){ //定义数组 var arr=[ ['Bill', 'Gardener'], [ 'Ben', 'Horticulturalist'],['你', 'Gardener'],['他', 'Gardener'],[ '我', 'Horticulturalist'] ]; var reader = new Ext.data.ArrayReader( 61 {}, //定义数组到 record 的映射关系 [ {name: 'name'}, {name: 'occupation', mapping: 1} ] ); //生成元数据 var store=new Ext.data.Store({ reader:reader }); store.loadData(arr); //现在配置列信息 var col=new Ext.grid.ColumnModel([ new Ext.grid.RowNumberer({header:'序号',width:30}), {header:'姓名',sortable: true,dataIndex:'name'}, {header:'职业',sortable: true,dataIndex:'occupation'} ]); //配置视图信息 var view=new Ext.grid.GridView({forceFit:true,sortAscText :'正序', sortDescText :'倒序'}); view.columnsText='列显示/隐藏'; //现在我们有一个可用的 grid 了,别骄傲这只是第一步 var grid=new Ext.grid.GridPanel({ el:Ext.getBody(), height:200, width:400, store:store, cm:col, view:view }); grid.render(); //现在我们需要一个 GroupingStore 62 var gstore=new Ext.data.GroupingStore({ reader:reader, groupField:'name', groupOnSort:true, sortInfo:{field: 'occupation', direction: "ASC"} //使用 GroupingStore 时必须指定 sortInfo 信息 }); gstore.loadData(arr); //扩展一下我们的 grid,让他能分组当然会更酷一点 var ggrid = new Ext.grid.GridPanel({ ds: gstore, cm:col, view: new Ext.grid.GroupingView({ forceFit:true, sortAscText :'正序', sortDescText :'倒序', columnsText:'列显示/隐藏', groupByText:'依本列分组', showGroupsText:'分组显示', groupTextTpl: '{text} ({[values.rs.length]} 条记录)' }), frame:true, width: 400, height: 300, collapsible: true, animCollapse: false, renderTo:Ext.getBody() }); }); 73、Ext.grid.EditorGridPanel 类 可编辑数据表格 Config { clicksToEdit : Number //点几次开始编辑,默认为 2 } 方法 EditorGridPanel()构造,应为 EditorGridPanel(Object config) startEditing( Number rowIndex, Number colIndex ) : void 开始编辑 stopEditing() : void 停止编辑 63 事件 afteredit : ( Object e ) beforeedit : ( Object e ) validateedit : ( Object e ) 下面我们扩展一下刚才的示例应用一下 EditorGridPanel//定义数组 var arr=[ ['Bill', 'Gardener','2007-01-02',-10,true], [ 'Ben', 'Horticulturalist','2007-01-03',-20.1,false], ['你', 'Gardener','2007-02-02',0,true], ['他', 'Gardener','2007-01-04',13,false], [ '我', 'Horticulturalist','2007-01-05',15.2,false] ]; var reader = new Ext.data.ArrayReader( ...{}, //定义数组到 record 的映射关系 [ ...{name: 'name'}, ...{name: 'occupation', mapping: 1}, ...{name:'date',type: 'date',dateFormat: 'Y-m-d'}, //用指定的格式转换日期 ...{name:'float',type:'float'}, ...{name:'bool',type:'bool'} ] ); //生成元数据 var store=new Ext.data.Store(...{ reader:reader }); store.loadData(arr); //自定义可编辑列,从 ext 的示例抄的,但是却要 init 郁闷 Ext.grid.CheckColumn = function(config)...{ Ext.apply(this, config); if(!this.id)...{ this.id = Ext.id(); } this.renderer = this.renderer.createDelegate(this); }; //重写了三个方法,捕捉 mousedown 修改数据 Ext.grid.CheckColumn.prototype =...{ init : function(grid)...{ this.grid = grid; this.grid.on('render', function()...{ var view = this.grid.getView(); view.mainBody.on('mousedown', this.onMouseDown, this); }, this); }, 64 onMouseDown : function(e, t)...{ if(t.className && t.className.indexOf('x-grid3-cc-'+this.id) != -1)...{ e.stopEvent(); var index = this.grid.getView().findRowIndex(t); var record = this.grid.store.getAt(index); record.set(this.dataIndex, !record.data[this.dataIndex]); } }, renderer : function(v, p, record)...{ p.css += ' x-grid3-check-col-td'; return '
 
'; } } //绑定到 bool 字段 var checkColumn=new Ext.grid.CheckColumn(...{ header: "布尔值", dataIndex: 'bool' }); /**//* 现在配置列信息,为了本地化日期选择器,请包含 ext-lang-zh_CN.js,并修改 Date.dayNames = ["日","一","二 ","三","四","五","六"]; 在 Ext.apply(Ext.DatePicker.prototype, {...})中加入 okText:"确定",cancelText:"取消"; */ var col=new Ext.grid.ColumnModel([ new Ext.grid.RowNumberer(...{header:'序号',width:30}), ...{header:'姓名',sortable: true,dataIndex:'name'}, ...{header:'职业',sortable: true,dataIndex:'occupation'}, ...{ id:'datacol', header:'日期', sortable:true, dataIndex:'date',renderer: Ext.util.Format.dateRenderer('Y 年 m 月 d 日'),//格式化显示 editor:new Ext.form.DateField() }, ...{header:' 数值',sortable:true,dataIndex:'float',renderer:formatFloat, align: 'right',editor:new Ext.form.NumberField()}, //自定义显示方式,右对齐 checkColumn //这个"选择框列"看起来的确漂亮些,其实是通过修改背景图片实现的 ]); //配置视图信息 var view=new Ext.grid.GridView(...{forceFit:true,sortAscText :'正序', sortDescText :'倒序'}); view.columnsText='列显示/隐藏'; //现在我们看看可编辑的数据表格能用了吗 var grid=new Ext.grid.EditorGridPanel(...{ el:Ext.getBody(), 65 height:200, width:400, store:store, cm:col, view:view }); //为什么原例不需要 init? checkColumn.init(grid); grid.render(); function formatFloat(val)...{ var bgcolor; if(val>0)...{ bgcolor='#FF0000'; }else if(val<0)...{ bgcolor='#00FF00'; } else...{ bgcolor='#000000'; } return( ['',val,''].join('')); } 74、Ext.grid.PropertyGrid 类 属性表格.继承自 EditorGridPanel,用习惯 ide 的用户都会喜欢这个简单的属性表格, config{ customEditors : Object //自定义属性编辑器 source : Object //数据源 } 方法 PropertyGrid( Object config )构造 getSource() : Object setSource( Object source ) : void 得到和设置数据源 事件 beforepropertychange : ( Object source, String recordId, Mixed value, propertychange : ( Object source, String recordId, Mixed value, Mixed 同样用一个简单的示例来完成 PropertyGrid 的学习 var grid=new Ext.grid.PropertyGrid(...{ el:Ext.getBody() ,height:200 ,width:400 66 ,viewConfig : ...{forceFit:true} ,customEditors:...{ '年龄':new Ext.grid.GridEditor(new Ext.form.NumberField()) } ,source:...{ '姓名':'blackant' ,'年龄':100 } }); grid.source['性别']='男'; grid.customEditors['性别']=new Ext.grid.GridEditor(new Ext.form.ComboBox(...{ editable:false ,triggerAction: 'all' ,store: new Ext.data.SimpleStore(...{ fields: ['gender'], data : [['男'],['女']] }) ,displayField:'gender' ,forceSelection:true ,mode:'local' })); grid.render();
还剩65页未读

继续阅读

下载pdf到电脑,查找使用更方便

pdf的实际排版效果,会与网站的显示效果略有不同!!

需要 10 金币 [ 分享pdf获得金币 ] 1 人已下载

下载pdf

pdf贡献者

dz051748

贡献于2013-04-09

下载需要 10 金币 [金币充值 ]
亲,您也可以通过 分享原创pdf 来获得金币奖励!
下载pdf