Ext.Element類

Element( String/HTMLElement element, [Boolean forceNew] )
由id或DOM節(jié)點(diǎn)創(chuàng)建Element對(duì)象

Element.fly( String/HTMLElement el, [String named] ) : Element
由id或DOM節(jié)點(diǎn)創(chuàng)建一個(gè)全局共享的活動(dòng)元素,可由named命名以避免可能的沖突

Element.get( Mixed el ) : Element
由id或DOM節(jié)點(diǎn)或已存在的Element得到一個(gè)Ext.Element對(duì)象

addClass( String/Array className ) : Ext.Element
為元素添加一個(gè)或多個(gè)css類名

addClassOnClick( String className ) : Ext.Element
為點(diǎn)擊事件添加和移除css類

addClassOnFocus( String className ) : Ext.Element
為得到和失去焦點(diǎn)添加和移除css類

addClassOnOver( String className, [Boolean preventFlicker] ) : Ext.Element
為鼠標(biāo)移入移出事件添加和移除css類(該方法未實(shí)際使用preventFlicker參數(shù))

addKeyListener( Number/Array/Object/String key, Function fn, [Object scope] ) : Ext.KeyMap
為對(duì)象添加按鍵偵聽 key由數(shù)值或字符串或{key: (number or array), shift: (true/false), ctrl: (true/false), alt: (true/false)}這樣的對(duì)象或他們的數(shù)組組成

addKeyMap( Object config ) : Ext.KeyMap
功能同addKeyListener,只是傳參方式不同
例:
el.addKeyMap({key : "ab",ctrl : true,fn: fn,scope:el });
和
el.addKeyListener({key:"ab",ctrl:true},fn,el);
是等價(jià)的,都是在 按下ctral+a或ctrl+b后呼叫fn

addListener( String eventName, Function fn, [Object scope], [Object options] ) : void
定義事件偵聽,eventName:事件名,fn:事件處理方法,scrope:范圍,其中options的定義比較復(fù)雜,可以包含以下屬性
scope {Object} : 處理fn的范圍
delegate {String} : 一個(gè)簡單選擇器(過濾目標(biāo)或?qū)ふ夷繕?biāo)的子孫節(jié)點(diǎn))
stopEvent {Boolean} : 阻止事件,等于preventDefault+stopPropagation
preventDefault {Boolean} : 阻止默認(rèn)活動(dòng)
stopPropagation {Boolean} : 阻止事件冒泡
normalized {Boolean} :設(shè)為flase將允許瀏覽器事件替代Ext.EventObject
delay {Number} : 延時(shí)多少毫秒后發(fā)生
single {Boolean} : 只運(yùn)行一次
buffer {Number} : 在Ext.util.DelayedTask中預(yù)定事件
當(dāng)然,還可能自定義參數(shù)以傳入function


alignTo( Mixed element, String position, [Array offsets], [Boolean/Object animate] ) : Ext.Element
將el對(duì)齊到element,positon,指示對(duì)齊的位置,可選以下定義
tl     左上角(默認(rèn))
t      上居中
tr     右上角
l      左邊界的中央
c      居中
r      右邊界的中央
bl     左下角
b      下居中
br     右下角
position還可以使用?約束移動(dòng)不能超出窗口
offsets 偏移量,以象素為單位
animate 詳見animate定義

例:div1.alignTo('div2','c-bl?',[20,0],true);
采用默認(rèn)動(dòng)畫將div1的最中央對(duì)齊到div2的左下角,并右移20個(gè)象素,且不能超出窗口


anchorTo( Mixed element, String position, [Array offsets], [Boolean/Object animate], [Boolean/Number monitorScroll], Function callback ) : Ext.Element
功能和alignTo類似,只是當(dāng)窗口重定義大小的時(shí)候也會(huì)引發(fā)重對(duì)齊事件
monitorScroll參數(shù)說明是否需要監(jiān)視滾動(dòng)條行為,如果定義為數(shù)值則是定義的延時(shí),單位為毫秒,默認(rèn)是50ms,
callback定義了animate完成后的回叫方法

animate( Object args, [Float duration], [Function onComplete], [String easing], [String animType] ) : Ext.Element
執(zhí)行動(dòng)畫.
args:目標(biāo)
duration:時(shí)間間隔.默認(rèn)是0.35
Function:完成后的回叫方法
easing:行為方法 默認(rèn)值是:easeOut,可選值在ext_base中找到,但沒有說明,以下內(nèi)容從yahoo ui中找到的
easeNone:勻速
easeIn:開始慢且加速
easeOut:開始快且減速
easeBoth:開始慢且減速
easeInStrong:開始慢且加速,t的四次方
easeOutStrong:開始快且減速,t的四次方
easeBothStrong:開始慢且減速,t的四次方
elasticIn:
elasticOut:
elasticBoth:
backIn:
backOut:
backBoth:
bounceIn:
bounceOut:
bounceBoth:
太多,慢慢體會(huì)吧
animType:定義動(dòng)畫類型,默認(rèn)值run 可選值:color/motion/scroll


appendChild( String/HTMLElement/Array/Element/CompositeElement el ) : Ext.Element
添加子元素el(el須已存在)

appendTo( Mixed el ) : Ext.Element
將當(dāng)前元素添加到el

applyStyles( String/Object/Function styles ) : Ext.Element
應(yīng)用樣式,styles是"width:100px"這樣的字符串或{width:"100px"}這樣的對(duì)象,function是指返回這樣的字串和對(duì)象的函數(shù),這是一個(gè)沒有用的批示,因?yàn)槿魏蝹鲄⒌牡胤蕉伎梢允欠祷匾箢愋偷膄unction.另見setStyle

autoHeight( [Boolean animate], [Float duration], [Function onComplete], [String easing] ) : Ext.Element
自適應(yīng)高度,參數(shù)都是老相識(shí)了,惟一需要注意的是這個(gè)方法使用了setTimeout,高度不會(huì)馬上變更

blur() : Ext.Element
失去焦點(diǎn),忽略所有的異常

boxWrap( [String class] ) : Ext.Element
用一個(gè)指定樣式class的div將當(dāng)前元素包含起來,class默認(rèn)值為x-box

center( [Mixed centerIn] ) : void
alignTo的簡華版.相當(dāng)于alignTo(centerIn || document, 'c-c'),當(dāng)前元素的中心對(duì)齊到centerIn元素的中心

child( String selector, [Boolean returnDom] ) : HTMLElement/Ext.Element
依selector選擇子孫節(jié)點(diǎn),依returnDom不同批示返回html元素還是ext元素,未定義或false時(shí)返回Ext.Element

clean( [Boolean forceReclean] ) : void
清除無用的空白文本節(jié)點(diǎn)(我喜歡這個(gè)想法)

clearOpacity() : Ext.Element
清除當(dāng)前元素樣式中不通用元素,清除ie中的filter,清除FF中的opacity/-moz-opacity/-khtml-opacity

clearPositioning( [String value] ) : Ext.Element
清除定位,恢復(fù)到默認(rèn)值,相當(dāng)于
this.setStyle({"left": value,"right": value,"top": value,"bottom": value,"z-index": "","position" : "static"});

clip() : Ext.Element
裁剪溢出部分,用unclip()恢復(fù)

contains( HTMLElement/String el ) : Boolean
當(dāng)前元素中是否存在el

createChild( Object config, [HTMLElement insertBefore], [Boolean returnDom] ) : Ext.Element
創(chuàng)建一個(gè)新的子節(jié)點(diǎn)
config :DomHelper元素對(duì)象,如果沒有特別指明tag,將使用div做默認(rèn)tag,詳情參見DomHelper,如果未定義insertBefore,則追加

createProxy( String/Object config, [String/HTMLElement renderTo], [Boolean matchBox] ) : Ext.Element
創(chuàng)建一個(gè)代理元素
config:代理元素的類名或DomHelper config對(duì)象
renderTo:將要繪制代理元素的html element或id
matchBox:是否對(duì)齊

createShim() : Ext.Element
在當(dāng)前元素之前創(chuàng)建一個(gè)classname為ext-shim的iframe,有什么用?

down( String selector, [Boolean returnDom] ) : HTMLElement/Ext.Element
通過樣式選擇器selector選擇子孫節(jié)點(diǎn)

enableDisplayMode( [String display] ) : Ext.Element
setVisibilityMode的簡便方法

findParent( String selector, [Number/Mixed maxDepth], [Boolean returnEl] ) : HTMLElement
通過簡單選擇器selector尋找祖先節(jié)點(diǎn) ,直到maxDepth(元素maxDepth默認(rèn)為10,也可以是指定的DOM 節(jié)點(diǎn)),找不到返回null

findParentNode( String selector, [Number/Mixed maxDepth], [Boolean returnEl] ) : HTMLElement
從父元素開始使用簡單選擇器selector選擇DOM節(jié)點(diǎn)

first( [String selector], [Boolean returnDom] ) : Ext.Element/HTMLElement
得到第一個(gè)符合selector條件的子節(jié)點(diǎn),跳過文本節(jié)點(diǎn)

focus() : Ext.Element
得到焦點(diǎn)

getAlignToXY( Mixed element, String position, [Array offsets] ) : Array
得到當(dāng)前元素按position規(guī)則對(duì)齊到element時(shí)的XY坐標(biāo)值 position/offsets參數(shù)參見alignTo方法

getAnchorXY( [String anchor], [Object size], [Boolean local] ) : Array
得到當(dāng)前元素錨點(diǎn)指定的坐標(biāo)值 anchor定義參見alignTo方法,默認(rèn)為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
得到當(dāng)前元素的底部縱坐標(biāo),元素縱坐標(biāo)+元素高度

getBox( [Boolean contentBox], [Boolean local] ) : Object
得到當(dāng)前元素的box對(duì)象:{x,y,width,height}

getCenterXY() : Array
如果當(dāng)前元素要居中對(duì)齊時(shí)的橫縱坐標(biāo)值,等價(jià)getAlignToXY(document, 'c-c')

getColor( String attr, String defaultValue, [String prefix] ) : void
得到當(dāng)前元素指定attr的顏色值,如果沒指定,返回defualtValue,比較郁悶的是明明不是void為什么api中批示是一個(gè)void?應(yīng)該是個(gè)字符串

getComputedHeight() : Number
得到計(jì)算過的高度,得到offsetHeight或css中定義的height值之一,如果使用了padding/borders,也會(huì)計(jì)算進(jìn)去

getComputedWidth() : Number
見getComputedHeight

getFrameWidth( String sides ) : Number
得到sides定義的border寬度和padding定義的寬度之和,side定義見getBorderWidth

getHeight( [Boolean contentHeight] ) : Number
返回元素的offsetHeight

getLeft( Boolean local ) : Number
得到橫坐標(biāo)

getMargins( [String sides] ) : Object/Number
如果沒有定義sides,則返回一個(gè)含有{left,top,width,height}對(duì)象,反之返回side指定的寬度,side定義見getBorderWidth

getOffsetsTo( Mixed element ) : Array
計(jì)算從element到當(dāng)前元素的偏移量

getPadding( String side ) : Number
得到由side指定的padding之和

getPositioning() : Object
得到當(dāng)前元素的位置信息 返回含以下屬性的對(duì)象{position,left,right,top,bottom,z-index}

getRegion() : Region
得到當(dāng)前元素的區(qū)域信息 返回含有以下屬性的Ext.lib.Region對(duì)象{top, left, bottom, right}

getRight( Boolean local ) : Number
右邊界值

getScroll() : Object
得到一個(gè)批示滾動(dòng)條位置的對(duì)象{left, top}

getSize( [Boolean contentSize] ) : Object
得到寬度和高度組成的對(duì)象信息{width,height}

getStyle( String property ) : String
得到指定的樣式值 getStyles簡化版

getStyles( String style1, String style2, String etc. ) : Object
得到由參數(shù)組成的對(duì)象
例:el.getStyles('color', 'font-size', 'width')
可能返回 {'color': '#FFFFFF', 'font-size': '13px', 'width': '100px'}

getTop( Boolean local ) : Number
得到頂點(diǎn)縱坐 標(biāo)

getUpdater() : Ext.Updater
得到當(dāng)前元素的Updater對(duì)象,參見Ext.Updater類

getValue( Boolean asNumber ) : String/Number
得到value屬性的值

getViewSize() : Object
得到clientHeight和clientWidth信息給成的對(duì)象{width,height}

getWidth( [Boolean contentWidth] ) : Number
..這樣的方法真多

getX() : Number
getXY() : Array
getY() : Array
得到頁面偏移量,也就是絕對(duì)坐標(biāo)

hasClass( String className ) : Boolean
樣式類className 存在于當(dāng)前元素的dom 節(jié)點(diǎn)中

hide( [Boolean/Object animate] ) : Ext.Element
隱藏當(dāng)前元素

hover( Function overFn, Function outFn, [Object scope] ) : Ext.Element
設(shè)置鼠標(biāo)移入移出事件

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
這個(gè)要放到 Ext.dd去專門搞了,用于拖曳

insertAfter( Mixed el ) : Ext.Element
insertBefore( Mixed el ) : Ext.Element
insertFirst( Mixed/Object el ) : Ext.Element
在DOM中el元素之前之后...插入當(dāng)前元素

insertHtml( String where, String html, Boolean returnEl )
插入html內(nèi)容 where 可選beforeBegin, afterBegin, beforeEnd, afterEnd

insertSibling( Mixed/Object/Array el, [String where], [Boolean returnDom] ) :
插入或創(chuàng)建el做為當(dāng)前元素的兄弟節(jié)點(diǎn),where可選before/after,默認(rèn)為before

is( String selector ) : Boolean
驗(yàn)證當(dāng)前節(jié)點(diǎn)是否匹配簡單選擇器selector

isBorderBox()
測試不同的樣式規(guī)則以決定當(dāng)前元素是否使用一個(gè)有邊框的盒子

isDisplayed() : Boolean
只要不是指定display屬性none都會(huì)返回真

isMasked() : Boolean
僅有當(dāng)前元素有mask并且可見時(shí)為真,mask譯為蒙片?就是有些輸入框沒得到值之前會(huì)有一行模糊的提示的那種東西

isScrollable() : Boolean
可以滾動(dòng)?

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
直接應(yīng)用當(dāng)前updater的update方法

mask( [String msg], [String msgCls] ) : Element
為當(dāng)前對(duì)象創(chuàng)建蒙片

move( String direction, Number distance, [Boolean/Object animate] ) : Ext.Element
相前元素相對(duì)于當(dāng)前位置移動(dòng),
direction批示方向可能的值是"l","left" - "r","right" - "t","top","up" - "b","bottom","down".
distance,指示要移動(dòng)的距離,以像素為單位

moveTo( Number x, Number y, [Boolean/Object animate] ) : Ext.Element
稱動(dòng)到指定的位置

next( [String selector], [Boolean returnDom] ) : Ext.Element/HTMLElement
下一個(gè)符合selector的兄弟節(jié)點(diǎn),

on( String eventName, Function fn, [Object scope], [Object options] ) : void
詳見addListener

position( [String pos], [Number zIndex], [Number x], [Number y] ) : void
初始化當(dāng)前元素的位置 pos可選擇relative/absolute/fixed

prev( [String selector], [Boolean returnDom] ) : Ext.Element/HTMLElement
前一個(gè)符合selector的兄弟節(jié)點(diǎn)

query( String selector ) : Array
通過樣式選擇器選擇子節(jié)點(diǎn)

radioClass( String/Array className ) : Ext.Element
添加樣式或樣式數(shù)組到當(dāng)前元素，并移除兄弟節(jié)點(diǎn)中的指定樣式

relayEvent( String eventName, Object object ) : void
將當(dāng)前元素的eventName事件同時(shí)轉(zhuǎn)發(fā)給object對(duì)象

remove() : void
從當(dāng)前DOM中刪除元素,并從緩存中移除

removeAllListeners() : Ext.Element
移除所有的偵聽者

removeClass( String/Array className ) : Ext.Element
移除樣式類

removeListener( String eventName, Function fn ) : Ext.Element
移除事件eventName的fn偵聽器

repaint() : Ext.Element
強(qiáng)制瀏覽器重繪當(dāng)前元素

replace( Mixed el ) : Ext.Element
用當(dāng)前元素替換el

replaceClass( String oldClassName, String newClassName ) : Ext.Element
替換樣式類

replaceWith( Mixed/Object el ) : Ext.Element
用el替換當(dāng)前元素

scroll( String direction, Number distance, [Boolean/Object animate] ) : Boolean
滾動(dòng),scroll會(huì)保證元素不會(huì)越界,direction和distance參數(shù)見move

scrollIntoView( [Mixed container], [Boolean hscroll] ) : Ext.Element
滾動(dòng)到container內(nèi)的視圖

scrollTo( String side, Number value, [Boolean/Object animate] ) : Element
基本與scroll方法相同,但不保證元素不越界

select( String selector, [Boolean unique] ) :
與query不同的是,通過樣式選擇器selector,select方法會(huì)返回一個(gè)復(fù)合元素對(duì)象(CompositeElement)或CompositeElementLite,

set( Object o, [Boolean useSet] ) : Ext.Element
設(shè)置屬性，例
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
設(shè)置css 對(duì)象的屬性值

setBounds( Number x, Number y, Number width, Number height, [Boolean/Object animate] ) : Ext.Element
馬上改變當(dāng)前元素的位置和尺寸

setBox( Object box, [Boolean adjust], [Boolean/Object animate] ) : Ext.Element
為當(dāng)前元素設(shè)置一個(gè)盒子box:{x, y, width, height},adjust指示是否馬上調(diào)整尺寸

setDisplayed( Boolean value ) : Ext.Element
設(shè)置可見性

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
設(shè)置高度和寬度

setLocation( Number x, Number y, [Boolean/Object animate] ) : Ext.Element
設(shè)置當(dāng)前元素相對(duì)于頁面的橫縱坐標(biāo)

setOpacity( Float opacity, [Boolean/Object animate] ) : Ext.Element
設(shè)置透明度，opacity為1完全不透明,0完全透明

setPositioning( Object posCfg ) : Ext.Element
為當(dāng)前元素指定位置信息,參數(shù)posCfg參見getPositioning說明

setRegion( Ext.lib.Region region, [Boolean/Object animate] ) : Ext.Element
為當(dāng)前元素指定區(qū)域信息 region定義 見getRegion

setStyle( String/Object property, [String value] ) : Ext.Element
設(shè)置樣式

setVisibilityMode( visMode Element.VISIBILITY ) : Ext.Element
指示是使用Element.VISIBILITY還是Element.DISPLAY屬性來定義可見性

setVisible( Boolean visible, [Boolean/Object animate] ) : Ext.Element
設(shè)置可見性


setX( Number The, [Boolean/Object animate] ) : Ext.Element
setXY( Array pos, [Boolean/Object animate] ) : Ext.Element
setY( Number The, [Boolean/Object animate] ) : Ext.Element
設(shè)置當(dāng)前元素相對(duì)于page的位置

show( [Boolean/Object animate] ) : Ext.Element
顯示當(dāng)前元素

swallowEvent( String eventName, [Boolean preventDefault] ) : Ext.Element
阻止eventName事件冒泡，并視preventDefault阻斷默認(rèn)行為

toggle( [Boolean/Object animate] ) : Ext.Element
切換元素的visibility 或display屬性,依賴于setVisibilityMode設(shè)定的

toggleClass( String className ) : Ext.Element
如果樣式名存在于當(dāng)前元素對(duì)應(yīng)的dom 節(jié)點(diǎn)，移除，反之應(yīng)用

translatePoints( Number/Array x, Number y ) : Object
返回一個(gè){left,top}結(jié)構(gòu)

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選擇祖先節(jié)點(diǎn)

update( String html, [Boolean loadScripts], Function callback ) : Ext.Element
利用html更新當(dāng)前節(jié)點(diǎn)內(nèi)容，loadScripts指示html中如果有script，是否需要運(yùn)行,這是一個(gè)innerHTML的一個(gè)老老老問題了

wrap( [Object config], [Boolean returnDom] ) : HTMLElement/Element
用另一個(gè)元素config包含自己

ExtJS教程- Hibernate教程-Struts2 教程-Lucene教程