打印版式

Class Ext.Element

Package: Ext
Class: Element
Extends: Object
Subclasses: Layer
Defined In: Element.js
呈现DOM里面的一个元素。

用法：
var el = Ext.get("my-div");

//  或者是 getEl
var el = getEl("my-div");

// 或者是一个 DOM element
var el = Ext.get(myDivElement);
使用Ext.get()或是getEl()来代替调用构造函数，保证每次调用都是获取相同的对象而非构建新的一个。

动画
操作DOM元素，很多情况下会用一些到动画效果（可选的）。 动画选项应该是布尔值（true ）或是Object Literal 。动画选项有： 
可选项    默认值    描述
--------- --------  ---------------------------------------------
duration  .35       动画持续的时间（单位：秒）
easing    easeOut   YUI的消除方法
callback  none      动画完成之后执行的函数
scope     this      回调函数的作用域
另外，可通过配置项中的“anim“来获取动画对象，这样便可停止或操控这个动画效果。例子如下： 

var el = Ext.get("my-div");

// 没有动画
el.setWidth(100);

// 默认动画
el.setWidth(100, true);

// 对动画的一些设置
el.setWidth(100, {
    duration: 1, 
    callback: this.foo, 
    scope: this
});

// 使用属性“anim”来获取动画对象
var opt = {
    duration: 1, 
    callback: this.foo, 
    scope: this
};
el.setWidth(100, opt);
...
if(opt.anim.isAnimated()){
    opt.anim.stop();
}
组合（集合的）元素
要处理一组的元素，参阅 Ext.CompositeElement

属性   -  方法   -  事件

公共属性

属性 定义对象
  Element.DISPLAY : Number Element
<static> 显示模式（Visibility mode）的常量 - 使用Display来隐藏元素
  Element.VISIBILITY : Number Element
<static> 显示模式（Visibility mode）的常量 - 使用Visibility来隐藏元素
  defaultUnit : String Element
如不指定CSS值的单位则默认为px。
  dom : HTMLElement Element
DOM元素
  id : String Element
DOM元素之ID
  originalDisplay : String Element
元素默认的显示模式

公共方法

方法 定义对象
  Element (String/HTMLElement element, [Boolean forceNew]) Element
直接创建新元素
  Element.fly (String/HTMLElement el, [String named]) : Element Element
<static> 获取共享元的元素，传入的节点会成为活动元素。
  Element.get (String/HTMLElement/Element el) : Element Element
<static> 获取元素对象的静态方法。
  addClass (String/Array className) : Ext.Element Element
为元素添加CSS类（CSS Class）。重复的类会被忽略。
  addClassOnClick (String className) : Ext.Element Element
当鼠标在该元素上面按下接着松开（即单击效果），设置event handlers来添加和移除css类。
  addClassOnFocus (String className) : Ext.Element Element
置event handlers来添加和移除css类，当该元素得到焦点（focus）。
  addClassOnOver (String className, [Boolean preventFlicker]) : Ext.Element Element
设置event handlers来添加和移除css类，当鼠标在该元素之上。
  addKeyListener (Number/Array/Object/String key, Function fn, [Object scope]) : Ext.KeyMap Element
构建KeyMap的快捷方式
  addKeyMap (Object config) : Ext.KeyMap Element
为该元素创建一个KeyMap
  addListener (String eventName, Function fn, [Object scope], [Object options]) : void Element
加入一个事件处理器
  alignTo (String/HTMLElement/Ext.Element element, String position, [Array offsets], [Boolean/Object animate]) : Ext.Element Element
对齐元素到另外一个元素的指定的标记。
  anchorTo (String/HTMLElement/Ext.Element element, String position, [Array offsets], [Boolean/Object animate], [Boolean/Number monitorScroll], ) : void Element
标记一个元素到另外一个元素，并当window resiz时重新对齐。
  animate (Object args, [Float duration], [Function onComplete], [String easing], [String animType]) : Ext.Element Element
在元素上执行动画
  appendChild (String/HTMLElement/Array/Element/CompositeElement el) : Ext.Element Element
传入一个或多个元素，加入到该元素
  appendTo (String/HTMLElement/Element el) : Ext.Element Element
传入元素的参数，将该元素加入到传入的元素
  applyStyles (String/Object/Function styles) : Ext.Element Element
setStyle的另一个版本，能更灵活地设置样式属性。
  autoHeight ([Boolean animate], [Float duration], [Function onComplete], [String easing]) : Ext.Element Element
测量元素其内容的实际高度，使元素之高度适合。
  beginMeasure () : Ext.Element Element
先对元素进行display:none， 然后临时激活偏移（width、height、x、y）。最后使用endMeasure()。
  blur () : Ext.Element Element
使这个元素失去焦点。忽略任何已捕获的异常。
  center ([String/HTMLElement/Ext.Element centerIn]) : void Element
在视图或其他元素中，居中元素。
  child (String selector, Boolean returnDom) : Element Element
传入一个CSS选择符的参数，然后基于该选择符和搜索深度，选取单个子节点（选择符不应有id）
  clean ([Boolean forceReclean]) : void Element
移除无用的文本节点
  clearOpacity () : Ext.Element Element
清除这个元素的透明度设置。IE有时候会用到
  clearPositioning ([String value]) : Ext.Element Element
当文档加载后清除位置并复位到默认
  clip () : Ext.Element Element
保存当前的溢出（overflow），然后进行裁剪元素的溢出部分 - 使用 unclip 来移除
  contains (HTMLElement/String el) : Boolean Element
返回true,如果这个元素是传入元素的父辈元素
  createChild (Object config, [HTMLElement insertBefore], [Boolean returnDom]) : Ext.Element Element
传入一个DomHelper配置项对象的参数，将其创建并加入其到该元素。
  createProxy (String/Object config, [String/HTMLElement renderTo], [Boolean matchBox]) : Ext.Element Element
创建元素的代理
  createShim () : Ext.Element Element
创建一个iframe垫片来使得select和其他windowed对象在该元素显示之下。
  down (String selector, Boolean returnDom) : Element Element
传入一个CSS选择符的参数，然后基于该选择符和搜索深度，"直接"选取单个子节点（选择符不应有id）
  enableDisplayMode ([String display]) : Ext.Element Element
setVisibilityMode(Element.DISPLAY)快捷方式
  endMeasure () : Ext.Element Element
在调用beginMeasure()之后恢复显示
  findParent (String ss, [Number/String/HTMLElement/Element maxDepth], [Boolean returnEl]) : HTMLElement Element
传入一个选择符的参数，找到整个节点并按照选择符查找父节点。
  findParentNode (String ss, [Number/String/HTMLElement/Element maxDepth], [Boolean returnEl]) : HTMLElement Element
传入一个选择符的参数，按照选择符查找父节点。选择符应是简易的选择符，如 div.some-class 或者 span:first-child。
  fitToParent ([Boolean monitorResize], [String/HTMLElment/Element targetParent]) : Ext.Element Element
调整该元素的大小，以适合父元素尺寸。需执行 box adjustments
  focus () : Ext.Element Element
使这个元素得到焦点。忽略任何已捕获的异常。
  getAlignToXY (String/HTMLElement/Ext.Element element, String position, [Array offsets]) : Array Element
获取该元素对齐另一个元素时候的x,y坐标。
  getAnchorXY ([String anchor], [Object size], [Boolean local]) : Array Element
返回X、Y坐标，由元素已标记好的位置（anchor position）指定。
  getBorderWidth (String side) : Number Element
获取指定边的边框宽度
  getBottom (Boolean local) : Number Element
获取元素的底部Y坐标 (元素Y位置 + 元素宽度)
  getBox ([Boolean contentBox], [Boolean local]) : Object Element
返回一个BOX {x, y, width, height}，可用于匹配其他元素的大小/位置。
  getCenterXY () : Array Element
计算该元素的x，y到屏幕中心的值
  getColor (String attr, String defaultValue, [String prefix]) : void Element
为指定的CSS属性返回CSS颜色。RGB、三位数(像#fff)和有效值都被转换到标准六位十六进制的颜色
  getComputedHeight () : Number Element
Returns either the offsetHeight or the height of this element based on CSS height adjusted by padding or borders when...
  getComputedWidth () : Number Element
Returns either the offsetWidth or the width of this element based on CSS width adjusted by padding or borders when ne...
  getFrameWidth (String sides) : Number Element
传入的“side”的参数，统计边框和内补丁（padding & borders）的宽度并返回该值。
  getHeight ([Boolean contentHeight]) : Number Element
返回元素的偏移（offset）高度
  getLeft (Boolean local) : Number Element
获取X坐标
  getMargins ([String sides]) : Object/Number Element
返回该元素的top、left、right 和 bottom 属性，以表示margin（外补丁）。
  getNextSibling () : HTMLElement Element
获取下一个兄弟节点，跳过文本节点。
  getPadding (String side) : Number Element
获取指定边的padding宽度
  getPositioning () : Object Element
获取一个包含CSS定位的对象。
  getPrevSibling () : HTMLElement Element
获取前一个兄弟节点，跳过文本节点。
  getRegion () : Region Element
返回给出元素的区域。
  getRight (Boolean local) : Number Element
获取元素的右X坐标 (元素X位置 + 元素宽度)
  getSize ([Boolean contentSize]) : Object Element
返回元素尺寸大小。
  getStyle (String property) : String Element
常规化当前样式和计算样式。这并不是YUI的getStyle，是一个已优化的版本。
  getStyles (String style1, String style2, String etc) : Object Element
给出一些CSS属性名，得到其值。
  getTop (Boolean local) : Number Element
获取顶部Y坐标
  getUpdateManager () : Ext.UpdateManager Element
获取这个元素的UpdateManager
  getValue (Boolean asNumber) : String/Number Element
返回“value”属性的值
  getWidth ([Boolean contentWidth]) : Number Element
返回元素的偏移（offset）宽度
  getX () : Number Element
获取元素基于页面坐标的X位置。
  getXY () : Array Element
获取元素基于页面坐标当前的位置。
  getY () : Number Element
获取元素基于页面坐标的Y位置。
  hasClass (String className) : Boolean Element
检查某个CSS类是否存在这个元素的DOM节点上。
  hide ([Boolean/Object animate]) : Ext.Element Element
隐藏这个元素, 使用display mode 来决定用 "display" 抑或 "visibility"。参阅 setVisible。
  initDD (String group, Object config, Object overrides) : Ext.dd.DD Element
为这个元素初始化 Ext.dd.DD 对象。
  initDDProxy (String group, Object config, Object overrides) : Ext.dd.DDProxy Element
为这个元素初始化 Ext.dd.DDProxy 对象。
  initDDTarget (String group, Object config, Object overrides) : Ext.dd.DDTarget Element
为这个元素初始化 Ext.dd.DDTarget 对象
  insertAfter (String/HTMLElement/Element el) : Ext.Element Element
传入元素的参数，将该元素的DOM插入其之后
  insertBefore (String/HTMLElement/Element el) : Ext.Element Element
传入元素的参数，将该元素的DOM插入其之前
  insertFirst (String/HTMLElement/Element/Object el) : Ext.Element Element
插入（或创建）一个元素（或DomHelper配置项对象）作为该元素的第一个子元素
  insertHtml (String where, String html) : HTMLElement Element
插入HTML片断到这个元素
  insertSibling (String/HTMLElement/Element/Object el, [String where], [Boolean returnDom]) : Ext.Element Element
插入（或创建）一个元素（或DomHelper配置项对象）作为该元素的兄弟节点。
  is (String ss) : Boolean Element
返回true，如果这个元素就是传入的简易选择符参数（如 div.some-class或span:first-child）
  isBorderBox () : Boolean Element
测试不同的CSS规则/浏览器以确定该元素是否使用Border Box
  isDisplayed () : Boolean Element
如果属性display不是"none"就返回true
  isMasked () : Boolean Element
返回true表示为这个元素应用了蒙板。
  isScrollable () : Boolean Element
返回true表示为该元素是可滚动的
  isVisible (Boolean deep) : Boolean Element
检查当前该元素是否都使用属性visibility和属性display来显示。
  load (String/Function url, [String/Object params], [Function callback], [Boolean discardUrl]) : Ext.Element Element
直接访问UpdateManager update() 的方法（使用相同的参数）
  mask ([String msg], [String msgCls]) : Element Element
在元素身上遮上一个蒙板（mask），以禁止用户操作。须core.css。
  move (String direction, Number distance, [Boolean/Object animate]) : Ext.Element Element
移动这个元素到相对于当前的位置。
  moveTo (Number x, Number y, [Boolean/Object animate]) : Ext.Element Element
设置元素在页面的坐标位置，不管这个元素如何定位。
  position ([String pos], [Number zIndex], [Number x], [Number y]) : void Element
初始化元素的定位。
  query (String selector) : Array Element
传入一个CSS选择符的参数，然后基于该选择符选取其子节点（选择符不应有id）
  radioClass (String className) : Ext.Element Element
添加一个或多个className到这个元素，并移除其兄弟（siblings）所有的样式。
  remove () : void Element
从DOM里面移除该元素，并从缓存中删除。
  removeAllListeners () : Ext.Element Element
在该元素身上移除所有已加入的侦听器
  removeClass (String/Array className) : Ext.Element Element
移除元素的CSS类
  removeListener (String eventName, Function fn) : Ext.Element Element
从这个元素上移除一个事件处理器（event handler）
  repaint () : Ext.Element Element
强制浏览器重新渲染该元素
  replace (String/HTMLElement/Element el) : Ext.Element Element
用这个元素替换掉传入的元素
  replaceClass (String oldClassName, String newClassName) : Ext.Element Element
在这个元素身上替换CSS类。
  scroll (String direction, Number distance, [Boolean/Object animate]) : Boolean Element
滚动该元素到指定的方向。
  scrollIntoView ([String/HTMLElement/Element container], [Boolean hscroll]) : Ext.Element Element
传入一个容器（container）参数，把元素滚动到容器的视图（View）。
  scrollTo (String side, Number value, [Boolean/Object animate]) : Element Element
滚动该元素到指定的滚动点（scroll point）。
  select (String selector, Boolean unique) : CompositeElement/CompositeElementLite Element
传入一个CSS选择符的参数，然后基于该选择符的子节点（Child nodes）创建一个 Ext.CompositeElement 组合元素。（选择符不应有id）
  set (Object o, [Boolean useSet]) : Ext.Element Element
传入属性（attributes）的参数，使之成为该元素的属性（一个样式的属性可以是字符串，对象或函数function）
  setBottom (String bottom) : Ext.Element Element
设置元素CSS Bottom的样式
  setBounds (Number x, Number y, Number width, Number height, [Boolean/Object animate]) : Ext.Element Element
一次过设置元素的位置和大小。
  setBox (Object box, [Boolean adjust], [Boolean/Object animate]) : Ext.Element Element
设置元素之Box。使用getBox() 在其他对象身上获取box对象。
  setDisplayed (Boolean value) : Ext.Element Element
设置css display。如果value为true，则使用originalDisplay。
  setHeight (Number height, [Boolean/Object animate]) : Ext.Element Element
设置元素的高度
  setLeft (String left) : Ext.Element Element
直接使用CSS样式（代替 setX），设定元素的left位置。
  setLeftTop () : Ext.Element Element
快速设置left和top（带默认单位）
  setLocation (Number x, Number y, [Boolean/Object animate]) : Ext.Element Element
设置元素在页面的坐标位置，不管这个元素如何定位。
  setOpacity (Float opacity, [Boolean/Object animate]) : Ext.Element Element
设置元素透明度
  setPositioning (Object posCfg) : Ext.Element Element
由getPositioning()返回的对象去设置定位。
  setRegion (Ext.lib.Region region, [Boolean/Object animate]) : Ext.Element Element
设置元素的位置并调整大小到指定的位置。
  setRight (String right) : Ext.Element Element
设置元素CSS Right的样式
  setSize (Number width, Number height, [Boolean/Object animate]) : Ext.Element Element
设置元素的大小尺寸。如果动画效果被打开，高度和宽度都会产生动画的变化效果。
  setStyle (String/Object property, [String val]) : Ext.Element Element
设置样式属性的包裹器，也可以用一个对象参数包含多个样式。
  setTop (String top) : Ext.Element Element
直接使用CSS样式（代替 setY），设定元素的top位置。
  setVisibilityMode (visMode Element.VISIBILITY) : Ext.Element Element
设置元素的可见模式。
  setVisible (Boolean visible, [Boolean/Object animate]) : Ext.Element Element
设置元素可见性（参阅细节）。
  setWidth (Number width, [Boolean/Object animate]) : Ext.Element Element
设置元素的宽度
  setX (Number The, [Boolean/Object animate]) : Ext.Element Element
设置元素基于页面坐标的X位置。
  setXY (Array pos, [Boolean/Object animate]) : Ext.Element Element
设置元素在页面的坐标位置，不管这个元素如何定位。
  setY (Number The, [Boolean/Object animate]) : Ext.Element Element
设置元素基于页面坐标的Y位置。
  show ([Boolean/Object animate]) : Ext.Element Element
显示这个元素 - 使用display mode 来决定用 "display" 抑或 "visibility"。参阅 setVisible。
  swallowEvent (String eventName, [Boolean preventDefault]) : Ext.Element Element
事件上报（bubbling）的过程中停止特定的事件，可选地阻止默认动作。
  toggle ([Boolean/Object animate]) : Ext.Element Element
转换元素visibility或display，取决于visibility mode。
  toggleClass (String className) : Ext.Element Element
轮换（Toggles）--添加或移除指定的CSS类（如果已经存在的话便删除，否则就是新增加）。
  translatePoints (Number/Array x, Number y, Object An) : void Element
传入一个页面坐标的参数，将其翻译到元素的CSS left/top值。
  unclip () : Ext.Element Element
在调用clip()之前，返回原始的裁剪部分（溢出的）
  unmask () : void Element
移除之前的蒙板。如果removeEl是true，则蒙板会被摧毁，否则放在缓存cache中。
  unselectable () : Ext.Element Element
禁止该元素的文本可被选择（可跨浏览器）。
  up (String ss, [Number/String/HTMLElement/Element maxDepth]) : Ext.Element Element
传入一个选择符的参数，按照选择符并沿着dom查找父节点。
  update (String html, [Boolean loadScripts], Function callback) : Ext.Element Element
更新该元素的innerHTML,遇到脚本可以执行。
  wrap ([Object config], [Boolean returnDom]) : /HTMLElementElement Element
创建和包裹（warp）该元素和其他元素

公共事件

此类没有公共事件。

属性详情

Element.DISPLAY

public Number Element.DISPLAY
<static> 显示模式（Visibility mode）的常量 - 使用Display来隐藏元素
这个属性由 Element 对象定义。

Element.VISIBILITY

public Number Element.VISIBILITY
<static> 显示模式（Visibility mode）的常量 - 使用Visibility来隐藏元素
这个属性由 Element 对象定义。

defaultUnit

public String defaultUnit
如不指定CSS值的单位则默认为px。
这个属性由 Element 对象定义。

dom

public HTMLElement dom
DOM元素
这个属性由 Element 对象定义。

id

public String id
DOM元素之ID
这个属性由 Element 对象定义。

originalDisplay

public String originalDisplay
元素默认的显示模式
这个属性由 Element 对象定义。

构造函数

Element

public function Element(String/HTMLElement element, [Boolean forceNew])
Create a new Element directly.
参数：
  • element : String/HTMLElement
  • forceNew : Boolean
    （可选）构建函数默认会检查在Cache中是否已经有这个element的实例，并是否能返回一致的实例。设置这个布尔值会中止检查（扩展这个类时较有用）。

方法详情

Element.fly

public function Element.fly(String/HTMLElement el, [String named])
<static> 获取共享元的元素，传入的节点会成为活动元素。不保存该元素的引用（reference）－可由其它代码重写dom节点。
参数：
  • el : String/HTMLElement
    Dom节点或id
  • named : String
    （可选）为避免某些冲突（如在ext内部的“_internal”），可另外起一个名字。
返回：
  • Element
    共享的元素对象
这个方法由 Element 对象定义。

Element.get

public function Element.get(String/HTMLElement/Element el)
<static> 获取元素对象的静态方法。如果是相同的对象的话，只是从缓存中提取。
参数：
  • el : String/HTMLElement/Element
    节点的id，一个DOM节点或是已存在的元素。
返回：
  • Element
    元素对象
这个方法由 Element 对象定义。

addClass

public function addClass(String/Array className)
为元素添加CSS类（CSS Class）。
参数：
  • className : String/Array
    要加入的CSS类或者由类组成的数组
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

addClassOnClick

public function addClassOnClick(String className)
当鼠标在该元素上面按下接着松开（即单击效果），设置event handlers来添加和移除css类。
参数：
  • className : String
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

addClassOnFocus

public function addClassOnFocus(String className)
设置event handlers来添加和移除css类，当该元素得到焦点（focus）。
参数：
  • className : String
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

addClassOnOver

public function addClassOnOver(String className, [Boolean preventFlicker])
设置event handlers来添加和移除css类，当鼠标在该元素之上。
参数：
  • className : String
  • preventFlicker : Boolean
    （可选）如果设置为true,则表示不会因mouseout事件引起在子元素上的轻移（Flicker）
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

addKeyListener

public function addKeyListener(Number/Array/Object/String key, Function fn, [Object scope])
构建KeyMap的快捷方式
参数：
  • key : Number/Array/Object/String
    可侦听代码的数值、key代码的数组的字串符，或者是像这样的object: {key: (number or array), shift: (true/false), ctrl: (true/false), alt: (true/false)}
  • fn : Function
    调用的函数
  • scope : Object
    （可选）函数的作用域
返回：
  • Ext.KeyMap
    创建好的KeyMap
这个方法由 Element 对象定义。

addKeyMap

public function addKeyMap(Object config)
为该元素创建一个KeyMap
参数：
  • config : Object
    KeyMap配置项。参阅 Ext.KeyMap
返回：
  • Ext.KeyMap
    创建好的KeyMap
这个方法由 Element 对象定义。

addListener

public function addListener(String eventName, Function fn, [Object scope], [Object options])
加入一个事件处理器
参数：
  • eventName : String
    加入事件的类型
  • fn : Function
    事件调用的方法
  • scope : Object
    （可选） 函数之作用域 (this 对象)
  • options : Object
    （可选）标准EventManager配置项对象
返回：
  • void
这个方法由 Element 对象定义。

alignTo

public function alignTo(String/HTMLElement/Ext.Element element, String position, [Array offsets], [Boolean/Object animate])
对齐元素到另外一个元素的指定的标记。如果这个元素是document，对齐到视图位置参数是可选的, 可指定为下列格式：
  • Blank: Defaults to aligning the element"s top-left corner to the target"s bottom-left corner ("tl-bl").
  • One anchor (deprecated): The passed anchor position is used as the target element's anchor point. The element being aligned will position its top-left corner (tl) to that point. This method has been deprecated in favor of the newer two anchor syntax below.
  • Two anchors: If two values from the table below are passed separated by a dash, the first value is used as the element"s anchor point, and the second value is used as the target"s anchor point.
In addition to the anchor points, the position parameter also supports the "?" character. If "?" is passed at the end of the position string, the element will attempt to align as specified, but the position will be adjusted to constrain to the viewport if necessary. Note that the element being aligned might be swapped to align to a different position than that specified in order to enforce the viewport constraints. Following are all of the supported anchor positions: 
Value  Description
-----  -----------------------------
tl     The top left corner (default)
t      The center of the top edge
tr     The top right corner
l      The center of the left edge
c      In the center of the element
r      The center of the right edge
bl     The bottom left corner
b      The center of the bottom edge
br     The bottom right corner
Example Usage: 

// align el to other-el using the default positioning ("tl-bl", non-constrained)
el.alignTo("other-el");

// align the top left corner of el with the top right corner of other-el (constrained to viewport)
el.alignTo("other-el", "tr?");

// align the bottom right corner of el with the center left edge of other-el
el.alignTo("other-el", "br-l?");

// align the center of el with the bottom left corner of other-el and
// adjust the x position by -6 pixels (and the y position by 0)
el.alignTo("other-el", "c-bl", [-6, 0]);
参数：
  • element : String/HTMLElement/Ext.Element
    要对齐的元素
  • position : String
    要对齐的位置
  • offsets : Array
    （可选）偏移位置 [x, y]
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

anchorTo

public function anchorTo(String/HTMLElement/Ext.Element element, String position, [Array offsets], [Boolean/Object animate], [Boolean/Number monitorScroll], )
标记一个元素到另外一个元素，并当window resiz时重新对齐。
参数：
  • element : String/HTMLElement/Ext.Element
    要对齐的元素
  • position : String
    要对齐的位置
  • offsets : Array
    （可选）偏移位置 [x, y]
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
  • monitorScroll : Boolean/Number
    （可选）true表示为监视body滚动并重新定位。如果该参数是一个数字，即意味有缓冲延时（默认为 50ms）
  • :
返回：
  • void
这个方法由 Element 对象定义。

animate

public function animate(Object args, [Float duration], [Function onComplete], [String easing], [String animType])
在元素上执行动画
参数：
  • args : Object
    YUI之动画配置参数
  • duration : Float
    （可选）动画持续多久 (默认为 .35 秒)
  • onComplete : Function
    （可选）动画完成后调用的函数
  • easing : String
    （可选）采用的“松开”方法 (默认为 'easeOut')
  • animType : String
    （可选）默认为'run'。可以是'color', 'motion', 或 'scroll'
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

appendChild

public function appendChild(String/HTMLElement/Array/Element/CompositeElement el)
传入一个或多个元素，加入到该元素
参数：
  • el : String/HTMLElement/Array/Element/CompositeElement
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

appendTo

public function appendTo(String/HTMLElement/Element el)
传入元素的参数，将该元素加入到传入的元素
参数：
  • el : String/HTMLElement/Element
    新父元素
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

applyStyles

public function applyStyles(String/Object/Function styles)
setStyle的另一个版本，能更灵活地设置样式属性。
参数：
  • styles : String/Object/Function
    表示样式的特定格式字符串，如“width:100px”，或是对象的形式如{width:"100px"}，或是能返回这些格式的函数
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

autoHeight

public function autoHeight([Boolean animate], [Float duration], [Function onComplete], [String easing])
测量元素其内容的实际高度，使元素之高度适合。注：改函数使用setTimeout而且新高度或者不会立即有效。
参数：
  • animate : Boolean
    （可选）变换 (默认 false)
  • duration : Float
    （可选）动画持续时间 (默认为 .35 seconds)
  • onComplete : Function
    （可选）动画完成后执行的函数
  • easing : String
    （可选）采用清除的方法（默认为easeOut）
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

beginMeasure

public function beginMeasure()
先对元素进行display:none， 然后临时激活偏移（width、height、x、y）。最后使用endMeasure()。
参数：
  • 无。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

blur

public function blur()
使这个元素失去焦点。忽略任何已捕获的异常。
参数：
  • 无。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

center

public function center([String/HTMLElement/Ext.Element centerIn])
在视图或其他元素中，居中元素。
参数：
  • centerIn : String/HTMLElement/Ext.Element
    （可选）在视图或其他元素中，居中元素。
返回：
  • void
这个方法由 Element 对象定义。

child

public function child(String selector, Boolean returnDom)
传入一个CSS选择符的参数，然后基于该选择符和搜索深度，选取单个子节点（选择符不应有id）
参数：
  • selector : String
    The CSS selector
  • returnDom : Boolean
    true表示为返回DOM节点代替Ext.Element(optional)（默认为false）
返回：
  • Element
    The element
这个方法由 Element 对象定义。

clean

public function clean([Boolean forceReclean])
移除无用的文本节点
参数：
  • forceReclean : Boolean
    （可选）默认地，元素会追踪自己是否已被清除了，所以你可以不断地调用这个方法。然而，如果你需要更新元素而且需要强制清除，你可以传入true的参数。
返回：
  • void
这个方法由 Element 对象定义。

clearOpacity

public function clearOpacity()
清除这个元素的透明度设置。IE有时候会用到
参数：
  • 无。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

clearPositioning

public function clearPositioning([String value])
当文档加载后清除位置并复位到默认
参数：
  • value : String
    （可选）用于 left,right,top,bottom的值, 默认为 '' (空白字符串)。你可使用 'auto'。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

clip

public function clip()
保存当前的溢出（overflow），然后进行裁剪元素的溢出部分 - 使用 unclip 来移除
参数：
  • 无。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

contains

public function contains(HTMLElement/String el)
返回true,如果这个元素是传入元素的父辈元素
参数：
  • el : HTMLElement/String
返回：
  • Boolean
这个方法由 Element 对象定义。

createChild

public function createChild(Object config, [HTMLElement insertBefore], [Boolean returnDom])
Creates the passed DomHelper config and appends it to this element or optionally inserts it before the passed child element.
参数：
  • config : Object
    DomHelper元素配置项对象
  • insertBefore : HTMLElement
    （可选）该元素的子元素
  • returnDom : Boolean
    （可选）true表示为返回DOM节点代替创建一个元素
返回：
  • Ext.Element
    新的子元素
这个方法由 Element 对象定义。

createProxy

public function createProxy(String/Object config, [String/HTMLElement renderTo], [Boolean matchBox])
创建元素的代理
参数：
  • config : String/Object
    代理元素的类名称或是DomHelper配置项对象
  • renderTo : String/HTMLElement
    （可选）成为代理的元素或是元素ID (默认为 document.body)
  • matchBox : Boolean
    （可选）true表示为立即和代理对齐和设置大小 (默认为 false)
返回：
  • Ext.Element
    新代理元素
这个方法由 Element 对象定义。

createShim

public function createShim()
创建一个iframe垫片来使得select和其他windowed对象在该元素显示之下。
参数：
  • 无。
返回：
  • Ext.Element
    新垫片元素
这个方法由 Element 对象定义。

down

public function down(String selector, Boolean returnDom)
传入一个CSS选择符的参数，然后基于该选择符和搜索深度，"直接"选取单个子节点（选择符不应有id）
参数：
  • selector : String
    CSS选择符
  • returnDom : Boolean
    true表示为返回DOM节点代替Ext.Element（默认为false）
返回：
  • Element
    元素对象
这个方法由 Element 对象定义。

enableDisplayMode

public function enableDisplayMode([String display])
setVisibilityMode(Element.DISPLAY)快捷方式
参数：
  • display : String
    （可选）当可见时显示的内容
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

endMeasure

public function endMeasure()
在调用beginMeasure()之后恢复显示
参数：
  • 无。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

findParent

public function findParent(String ss, [Number/String/HTMLElement/Element maxDepth], [Boolean returnEl])
传入一个选择符的参数，找到整个节点并按照选择符查找父节点。选择符应是简易的选择符，如 div.some-class or span:first-child。
参数：
  • ss : String
    要测试的简易选择符
  • maxDepth : Number/String/HTMLElement/Element
    （可选）搜索深度（MaxDepth），可以为number或元素(默认是 10 || document.body)
  • returnEl : Boolean
    （可选）True：返回Ext.Element对象代替DOM节点
返回：
  • HTMLElement
这个方法由 Element 对象定义。

findParentNode

public function findParentNode(String ss, [Number/String/HTMLElement/Element maxDepth], [Boolean returnEl])
传入一个选择符的参数，按照选择符查找父节点。选择符应是简易的选择符，如 div.some-class 或者 span:first-child。
参数：
  • ss : String
    要测试的简易选择符
  • maxDepth : Number/String/HTMLElement/Element
    （可选）搜索深度（MaxDepth），可以为number或元素(默认是 10 || document.body)
  • returnEl : Boolean
    （可选）True：返回Ext.Element对象代替DOM节点
返回：
  • HTMLElement
这个方法由 Element 对象定义。

fitToParent

public function fitToParent([Boolean monitorResize], [String/HTMLElment/Element targetParent])
调整该元素的大小，以适合父元素尺寸。需执行 box adjustments
参数：
  • monitorResize : Boolean
    （可选）随着window改变大小而调整
  • targetParent : String/HTMLElment/Element
    （可选）目标元素，默认是父节点。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

focus

public function focus()
使这个元素得到焦点。忽略任何已捕获的异常。
参数：
  • 无。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

getAlignToXY

public function getAlignToXY(String/HTMLElement/Ext.Element element, String position, [Array offsets])
获取该元素对齐另一个元素时候的x,y坐标。 See alignTo for more info on the supported position values.
参数：
  • element : String/HTMLElement/Ext.Element
    要对齐的元素
  • position : String
    要对齐的位置
  • offsets : Array
    （可选）偏移位置 [x, y]
返回：
  • Array
    [x, y]
这个方法由 Element 对象定义。

getAnchorXY

public function getAnchorXY([String anchor], [Object size], [Boolean local])
返回X、Y坐标，由元素已标记好的位置（anchor position）指定。
参数：
  • anchor : String
    （可选）指定的标记位置（默认为 "c"）。参阅 alignTo 可支持的标记好的位置（anchor position）之细节。
  • size : Object
    （可选）用于计算标记位置的对象{width: (目标宽度), height: (目标高度)} (默认为元素当前大小)
  • local : Boolean
    （可选）true表示为获取局部的(元素相对的 top/left) 标记的位置而非页面坐标
返回：
  • Array
    [x, y] 包含元素X、Y坐标的数组
这个方法由 Element 对象定义。

getBorderWidth

public function getBorderWidth(String side)
获取指定边的边框宽度
参数：
  • side : String
    可以是 t, l, r, b或是任何组合。例如，传入lr的参数会得到(l)eft padding +(r)ight padding
返回：
  • Number
    四边的padding之和
这个方法由 Element 对象定义。

getBottom

public function getBottom(Boolean local)
获取元素的底部Y坐标 (元素Y位置 + 元素宽度)
参数：
  • local : Boolean
    True ：获取局部CSS位置代替页面坐标
返回：
  • Number
这个方法由 Element 对象定义。

getBox

public function getBox([Boolean contentBox], [Boolean local])
返回一个BOX {x, y, width, height}，可用于匹配其他元素的大小/位置。
参数：
  • contentBox : Boolean
    （可选）true表示为返回元素内容的BOX。
  • local : Boolean
    （可选）true表示为返回元素的left和top代替页面的x/y。
返回：
  • Object
这个方法由 Element 对象定义。

getCenterXY

public function getCenterXY()
计算该元素的x，y到屏幕中心的值
参数：
  • 无。
返回：
  • Array
    x, y值为 [x, y]
这个方法由 Element 对象定义。

getColor

public function getColor(String attr, String defaultValue, [String prefix])
为指定的CSS属性返回CSS颜色。RGB、三位数(像#fff)和有效值都被转换到标准六位十六进制的颜色
参数：
  • attr : String
    CSS属性
  • defaultValue : String
    当找不到有效的颜色时所用的默认值
  • prefix : String
    （可选）默认为 #。应用到YUI颜色动画时须为空白字串符
返回：
  • void
这个方法由 Element 对象定义。

getComputedHeight

public function getComputedHeight()
Returns either the offsetHeight or the height of this element based on CSS height adjusted by padding or borders when needed to simulate offsetHeight when offsets aren't available. This may not work on display:none elements if a height has not been set using CSS.
参数：
  • 无。
返回：
  • Number
这个方法由 Element 对象定义。

getComputedWidth

public function getComputedWidth()
Returns either the offsetWidth or the width of this element based on CSS width adjusted by padding or borders when needed to simulate offsetWidth when offsets aren't available. This may not work on display:none elements if a width has not been set using CSS.
参数：
  • 无。
返回：
  • Number
这个方法由 Element 对象定义。

getFrameWidth

public function getFrameWidth(String sides)
传入的“side”的参数，统计边框和内补丁（padding & borders）的宽度并返回该值。参阅getBorderWidth()以得到更多sides的资料
参数：
  • sides : String
返回：
  • Number
这个方法由 Element 对象定义。

getHeight

public function getHeight([Boolean contentHeight])
返回元素的偏移（offset）高度
参数：
  • contentHeight : Boolean
    （可选）true表示为获取减去边框和内补丁（borders & padding）的宽度
返回：
  • Number
    元素高度
这个方法由 Element 对象定义。

getLeft

public function getLeft(Boolean local)
获取X坐标
参数：
  • local : Boolean
    true表示为获取局部CSS位置代替页面坐标
返回：
  • Number
这个方法由 Element 对象定义。

getMargins

public function getMargins([String sides])
返回该元素的top、left、right 和 bottom 属性，以表示margin（外补丁）。若有sides参数传入，即返回已计算好的sides宽度。
参数：
  • sides : String
    （可选）任何 l, r, t, b的组合，以获取该 sides的统计。
返回：
  • Object/Number
这个方法由 Element 对象定义。

getNextSibling

public function getNextSibling()
获取下一个兄弟节点，跳过文本节点。
参数：
  • 无。
返回：
  • HTMLElement
    下一个兄弟节点或是null
这个方法由 Element 对象定义。

getPadding

public function getPadding(String side)
获取指定边的padding宽度
参数：
  • side : String
    可以是 t, l, r, b或是任何组合。例如，传入lr的参数会得到(l)eft padding +(r)ight padding
返回：
  • Number
    四边的padding之和
这个方法由 Element 对象定义。

getPositioning

public function getPositioning()
获取一个包含CSS定位的对象。有用的技巧：连同setPostioning一起，可在更新执行之前，先做一个快照（snapshot），之后便可恢复该元素。
参数：
  • 无。
返回：
  • Object
这个方法由 Element 对象定义。

getPrevSibling

public function getPrevSibling()
获取前一个兄弟节点，跳过文本节点。
参数：
  • 无。
返回：
  • HTMLElement
    前一个兄弟节点或是null
这个方法由 Element 对象定义。

getRegion

public function getRegion()
返回给出元素的区域。元素必须是DOM树中的一部分，才拥有页面坐标（display:none或未加入的elements返回 false）。
参数：
  • 无。
返回：
  • Region
    Ext.lib.Region 包含"top, left, bottom, right" 成员数据
这个方法由 Element 对象定义。

getRight

public function getRight(Boolean local)
获取元素的右X坐标 (元素X位置 + 元素宽度)
参数：
  • local : Boolean
    True ：获取局部CSS位置代替页面坐标
返回：
  • Number
这个方法由 Element 对象定义。

getSize

public function getSize([Boolean contentSize])
返回元素尺寸大小。
参数：
  • contentSize : Boolean
    （可选）true表示为返回减去border和padding的宽度大小
返回：
  • Object
    包含元素大小尺寸的对象，如{width: (element width), height: (element height)}
这个方法由 Element 对象定义。

getStyle

public function getStyle(String property)
常规化当前样式和计算样式。这并不是YUI的getStyle，是一个已优化的版本。
参数：
  • property : String
    返回值的那个样式属性。
返回：
  • String
    该元素样式属性的当前值。
这个方法由 Element 对象定义。

getStyles

public function getStyles(String style1, String style2, String etc)
给出一些CSS属性名，得到其值。如 el.getStyles('color', 'font-size', 'width') 会返回 {'color': '#FFFFFF', 'font-size': '13px', 'width': '100px'}。
参数：
  • style1 : String
  • style2 : String
  • etc : String
返回：
  • Object
这个方法由 Element 对象定义。

getTop

public function getTop(Boolean local)
获取顶部Y坐标
参数：
  • local : Boolean
    true 获取局部CSS位置代替页面坐标
返回：
  • Number
这个方法由 Element 对象定义。

getUpdateManager

public function getUpdateManager()
获取这个元素的UpdateManager
参数：
  • 无。
返回：
  • Ext.UpdateManager
    UpdateManager 对象
这个方法由 Element 对象定义。

getValue

public function getValue(Boolean asNumber)
返回“value”属性的值
参数：
  • asNumber : Boolean
    true 表示为将值解析为数字
返回：
  • String/Number
这个方法由 Element 对象定义。

getWidth

public function getWidth([Boolean contentWidth])
返回元素的偏移（offset）宽度
参数：
  • contentWidth : Boolean
    （可选）true表示为获取减去边框和内补丁（borders & padding）的宽度
返回：
  • Number
    元素宽度
这个方法由 Element 对象定义。

getX

public function getX()
获取元素基于页面坐标的X位置。元素必须是DOM树中的一部分，才拥有页面坐标（display:none或未加入的elements返回 false）。
参数：
  • 无。
返回：
  • Number
    元素的X位置
这个方法由 Element 对象定义。

getXY

public function getXY()
获取元素基于页面坐标当前的位置。元素必须是DOM树中的一部分，才拥有页面坐标（display:none或未加入的elements返回 false）。
参数：
  • 无。
返回：
  • Array
    元素的XY位置
这个方法由 Element 对象定义。

getY

public function getY()
获取元素基于页面坐标的Y位置。元素必须是DOM树中的一部分，才拥有页面坐标（display:none或未加入的elements返回 false）。
参数：
  • 无。
返回：
  • Number
    元素的Y位置
这个方法由 Element 对象定义。

hasClass

public function hasClass(String className)
检查某个CSS类是否存在这个元素的DOM节点上。
参数：
  • className : String
    要检查CSS类
返回：
  • Boolean
    true表示为类是有的，否则为false
这个方法由 Element 对象定义。

hide

public function hide([Boolean/Object animate])
隐藏这个元素, 使用display mode 来决定用 "display" 抑或 "visibility"。参阅 setVisible。
参数：
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

initDD

public function initDD(String group, Object config, Object overrides)
为这个元素初始化 Ext.dd.DD 对象。
参数：
  • group : String
    DD对象隶属于的那个组
  • config : Object
    DD之配置对象
  • overrides : Object
    包含一些方法的对象，用于重写或实现（override/implement）DDTarget对象
返回：
  • Ext.dd.DD
    DD对象
这个方法由 Element 对象定义。

initDDProxy

public function initDDProxy(String group, Object config, Object overrides)
为这个元素初始化 Ext.dd.DDProxy 对象。
参数：
  • group : String
    DDProxy对象隶属于的那个组
  • config : Object
    DDProxy之配置对象
  • overrides : Object
    包含一些方法的对象，用于重写或实现（override/implement）DDTarget对象
返回：
  • Ext.dd.DDProxy
    DDProxy对象
这个方法由 Element 对象定义。

initDDTarget

public function initDDTarget(String group, Object config, Object overrides)
为这个元素初始化 Ext.dd.DDTarget 对象
参数：
  • group : String
    DDTarget对象隶属于的那个组
  • config : Object
    DDTarget之配置对象
  • overrides : Object
    包含一些方法的对象，用于重写或实现（override/implement）DDTarget对象
返回：
  • Ext.dd.DDTarget
    DDTarget对象
这个方法由 Element 对象定义。

insertAfter

public function insertAfter(String/HTMLElement/Element el)
传入元素的参数，将该元素的DOM插入其之后
参数：
  • el : String/HTMLElement/Element
    在它后面插入的那个元素
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

insertBefore

public function insertBefore(String/HTMLElement/Element el)
传入元素的参数，将该元素的DOM插入其之前
参数：
  • el : String/HTMLElement/Element
    在它前面插入的那个元素
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

insertFirst

public function insertFirst(String/HTMLElement/Element/Object el)
插入（或创建）一个元素（或DomHelper配置项对象）作为该元素的第一个子元素
参数：
  • el : String/HTMLElement/Element/Object
    可以是id；或是插入的元素；或是要创建和插入的DomHelper配置项对象
返回：
  • Ext.Element
    新子元素
这个方法由 Element 对象定义。

insertHtml

public function insertHtml(String where, String html)
插入HTML片断到这个元素
参数：
  • where : String
    要插入的html放在元素的哪里 - beforeBegin, afterBegin, beforeEnd, afterEnd.
  • html : String
    HTML片断
返回：
  • HTMLElement
    被插入之节点（或最近的，如果超过一处插入的话）
这个方法由 Element 对象定义。

insertSibling

public function insertSibling(String/HTMLElement/Element/Object el, [String where], [Boolean returnDom])
插入（或创建）一个元素（或DomHelper配置项对象）作为该元素的兄弟节点。
参数：
  • el : String/HTMLElement/Element/Object
    可以是id；或是插入的元素；或是要创建和插入的DomHelper配置项对象
  • where : String
    （可选）'before' 或 'after' 默认为 before
  • returnDom : Boolean
    （可选）true表示返回没加工过的DOM元素而非Ext.Element
返回：
  • Ext.Element
    插入的元素
这个方法由 Element 对象定义。

is

public function is(String ss)
返回true，如果这个元素就是传入的简易选择符参数（如 div.some-class或span:first-child）
参数：
  • ss : String
    要测试的简易选择符
返回：
  • Boolean
这个方法由 Element 对象定义。

isBorderBox

public function isBorderBox()
测试不同的CSS规则/浏览器以确定该元素是否使用Border Box
参数：
  • 无。
返回：
  • Boolean
这个方法由 Element 对象定义。

isDisplayed

public function isDisplayed()
如果属性display不是"none"就返回true
参数：
  • 无。
返回：
  • Boolean
这个方法由 Element 对象定义。

isMasked

public function isMasked()
返回true表示为这个元素应用了蒙板。
参数：
  • 无。
返回：
  • Boolean
这个方法由 Element 对象定义。

isScrollable

public function isScrollable()
返回true表示为该元素是可滚动的
参数：
  • 无。
返回：
  • Boolean
这个方法由 Element 对象定义。

isVisible

public function isVisible(Boolean deep)
检查当前该元素是否都使用属性visibility和属性display来显示。
参数：
  • deep : Boolean
    True：沿着DOM一路看父元素是否隐藏的。
返回：
  • Boolean
    true表示该元素当前是可见的，否则返回false
这个方法由 Element 对象定义。

load

public function load(String/Function url, [String/Object params], [Function callback], [Boolean discardUrl])
直接访问UpdateManager update() 的方法（使用相同的参数）
参数：
  • url : String/Function
    针对该请求的url或是能返回url的函数
  • params : String/Object
    （可选）作为url一部分的参数，可以是已编码的字符串"param1=1&param2=2"，或是一个对象{param1: 1, param2: 2}
  • callback : Function
    （可选）请求往返完成后的回调，调用时有参数(oElement, bSuccess)
  • discardUrl : Boolean
    （可选）默认情况下你执行一次更新后，最后一次url会保存到defaultUrl。如果true的话，将不会保存。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

mask

public function mask([String msg], [String msgCls])
在元素身上遮上一个蒙板（mask），以禁止用户操作。须core.css。这个方法只能用于接受子节点（child nodes）的元素。
参数：
  • msg : String
    （可选）蒙板显示的信息
  • msgCls : String
    （可选）信息元素的CSS类
返回：
  • Element
    信息元素
这个方法由 Element 对象定义。

move

public function move(String direction, Number distance, [Boolean/Object animate])
移动这个元素到相对于当前的位置。
参数：
  • direction : String
    可能出现的值： "l","left" - "r","right" - "t","top","up" - "b","bottom","down".
  • distance : Number
    元素移动有多远（像素）
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

moveTo

public function moveTo(Number x, Number y, [Boolean/Object animate])
设置元素在页面的坐标位置，不管这个元素如何定位。 The元素必须是DOM树中的一部分，才拥有页面坐标（display:none或未加入的elements返回 false）。
参数：
  • x : Number
    新定位的X值（基于页面坐标）
  • y : Number
    新定位的Y值（基于页面坐标）
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

position

public function position([String pos], [Number zIndex], [Number x], [Number y])
初始化元素的定位。如果不传入一个特定的定位，而又还没定位的话，将会使这个元素 相对（relative）定位
参数：
  • pos : String
    （可选）使用 "relative", "absolute" 或 "fixed"的定位
  • zIndex : Number
    （可选）z-Index值
  • x : Number
    （可选）设置页面 X方向位置
  • y : Number
    （可选）设置页面 Y方向位置
返回：
  • void
这个方法由 Element 对象定义。

query

public function query(String selector)
传入一个CSS选择符的参数，然后基于该选择符选取其子节点（选择符不应有id）
参数：
  • selector : String
    CSS选择符
返回：
  • Array
    匹配节点之数组
这个方法由 Element 对象定义。

radioClass

public function radioClass(String className)
添加一个或多个className到这个元素，并移除其兄弟（siblings）所有的样式。
参数：
  • className : String
    要加入的className,或者是由类组成的数组
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

remove

public function remove()
从DOM里面移除该元素，并从缓存中删除。
参数：
  • 无。
返回：
  • void
这个方法由 Element 对象定义。

removeAllListeners

public function removeAllListeners()
在该元素身上移除所有已加入的侦听器
参数：
  • 无。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

removeClass

public function removeClass(String/Array className)
移除元素的CSS类
参数：
  • className : String/Array
    要移除的CSS类或者由类组成的数组
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

removeListener

public function removeListener(String eventName, Function fn)
从这个元素上移除一个事件处理器（event handler）
参数：
  • eventName : String
    要移除事件的类型
  • fn : Function
    事件调用的方法
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

repaint

public function repaint()
强制浏览器重新渲染该元素
参数：
  • 无。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

replace

public function replace(String/HTMLElement/Element el)
用这个元素替换掉传入的元素
参数：
  • el : String/HTMLElement/Element
    要替换的元素
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

replaceClass

public function replaceClass(String oldClassName, String newClassName)
在这个元素身上替换CSS类。
参数：
  • oldClassName : String
    要被替换之CSS类
  • newClassName : String
    新CSS类
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

scroll

public function scroll(String direction, Number distance, [Boolean/Object animate])
滚动该元素到指定的方向。须确认元素可滚动的范围，以免滚动超出元素可滚动的范围。
参数：
  • direction : String
    可能出现的值: "l","left" - "r","right" - "t","top","up" - "b","bottom","down".
  • distance : Number
    元素滚动有多远（像素）
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Boolean
    true：滚动完成；false表示为元素能滚动其最远的
这个方法由 Element 对象定义。

scrollIntoView

public function scrollIntoView([String/HTMLElement/Element container], [Boolean hscroll])
传入一个容器（container）参数，把元素滚动到容器的视图（View）。
参数：
  • container : String/HTMLElement/Element
    （可选）滚动容器的元素 (默认为 document.body)
  • hscroll : Boolean
    （可选）false：禁止水平滚动
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

scrollTo

public function scrollTo(String side, Number value, [Boolean/Object animate])
滚动该元素到指定的滚动点（scroll point）。它不会边界检查所以若果你滚动到一个不合理的值时它也会试着去做。要自动检查边界，请使用scroll()。
参数：
  • side : String
    即可 "left" 对应scrollLeft的值，也可以 "top" 对于scrollTop的值.
  • value : Number
    新滚动值
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Element
    this
这个方法由 Element 对象定义。

select

public function select(String selector, Boolean unique)
传入一个CSS选择符的参数，然后基于该选择符的子节点（Child nodes）创建一个 Ext.CompositeElement 组合元素。（选择符不应有id）
参数：
  • selector : String
    CSS选择符
  • unique : Boolean
    true:为每个子元素创建独一无二的 Ext.Element（默认为false享元的普通对象flyweight object)
返回：
  • CompositeElement/CompositeElementLite
    组合元素
这个方法由 Element 对象定义。

set

public function set(Object o, [Boolean useSet])
传入属性（attributes）的参数，使之成为该元素的属性（一个样式的属性可以是字符串，对象或函数function）
参数：
  • o : Object
    属性对象
  • useSet : Boolean
    （可选）false表示为用expandos来重写默认的setAttribute
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setBottom

public function setBottom(String bottom)
设置元素CSS Bottom的样式
参数：
  • bottom : String
    Bottom CSS属性值
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setBounds

public function setBounds(Number x, Number y, Number width, Number height, [Boolean/Object animate])
一次过设置元素的位置和大小。如果动画效果被打开，高度和宽度都会产生动画的变化效果。
参数：
  • x : Number
    新位置上的x值（基于页面的坐标）
  • y : Number
    新位置上的y值（基于页面的坐标）
  • width : Number
    新宽度
  • height : Number
    新高度
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setBox

public function setBox(Object box, [Boolean adjust], [Boolean/Object animate])
设置元素之Box。使用getBox() 在其他对象身上获取box对象。如果动画为true，那么高度和宽度都会同时出现动画效果。
参数：
  • box : Object
    填充的Box {x, y, width, height}
  • adjust : Boolean
    （可选）是否自动调整由box-mode问题引起的高度和宽度设置
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setDisplayed

public function setDisplayed(Boolean value)
设置css display。如果value为true，则使用originalDisplay。
参数：
  • value : Boolean
    如果value为true，则使用originalDisplay。否则直接设置显示的字符串、
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setHeight

public function setHeight(Number height, [Boolean/Object animate])
设置元素的高度
参数：
  • height : Number
    新高度
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setLeft

public function setLeft(String left)
直接使用CSS样式（代替 setX），设定元素的left位置。
参数：
  • left : String
    CSS属性left的值
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setLeftTop

public function setLeftTop()
快速设置left和top（带默认单位）
参数：
  • 无。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setLocation

public function setLocation(Number x, Number y, [Boolean/Object animate])
设置元素在页面的坐标位置，不管这个元素如何定位。 The元素必须是DOM树中的一部分，才拥有页面坐标（display:none或未加入的elements返回 false）。
参数：
  • x : Number
    新位置上的x值（基于页面的坐标）
  • y : Number
    新位置上的y值（基于页面的坐标）
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setOpacity

public function setOpacity(Float opacity, [Boolean/Object animate])
设置元素透明度
参数：
  • opacity : Float
    新的透明度。 0 = 透明, .5 = 50% 可见, 1 =完全可见, 等等
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setPositioning

public function setPositioning(Object posCfg)
由getPositioning()返回的对象去设置定位。
参数：
  • posCfg : Object
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setRegion

public function setRegion(Ext.lib.Region region, [Boolean/Object animate])
设置元素的位置并调整大小到指定的位置。如果动画效果被打开，高度和宽度都会产生动画的变化效果。
参数：
  • region : Ext.lib.Region
    要填充的区域
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setRight

public function setRight(String right)
设置元素CSS Right的样式
参数：
  • right : String
    Right CSS属性值
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setSize

public function setSize(Number width, Number height, [Boolean/Object animate])
设置元素的大小尺寸。如果动画效果被打开，高度和宽度都会产生动画的变化效果。
参数：
  • width : Number
    新宽度
  • height : Number
    新高度
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setStyle

public function setStyle(String/Object property, [String val])
设置样式属性的包裹器，也可以用一个对象参数包含多个样式。
参数：
  • property : String/Object
    要设置的样式属性，或是包含多个样式的对象
  • val : String
    （可选）样式属性的值，如果第一个参数是对象，则这个参数为null
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setTop

public function setTop(String top)
直接使用CSS样式（代替 setY），设定元素的top位置。
参数：
  • top : String
    CSS属性top的值
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setVisibilityMode

public function setVisibilityMode(visMode Element.VISIBILITY)
设置元素的可见模式。当调用setVisible()时，会确定可见模式究竟是“visibility”的还是“display”的。
参数：
  • Element.VISIBILITY : visMode
    Element.VISIBILITY 或 Element.DISPLAY
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setVisible

public function setVisible(Boolean visible, [Boolean/Object animate])
设置元素可见性（参阅细节）。如果visibilityMode 被设置成 Element.DISPLAY，那么它会使用display属性来隐藏元素，否则它会使用visibility。默认是使用 visibility属性。
参数：
  • visible : Boolean
    元素是否可见的
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setWidth

public function setWidth(Number width, [Boolean/Object animate])
设置元素的宽度
参数：
  • width : Number
    新宽度
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setX

public function setX(Number The, [Boolean/Object animate])
设置元素基于页面坐标的X位置。元素必须是DOM树中的一部分，才拥有页面坐标（display:none或未加入的elements返回 false）。
参数：
  • The : Number
    元素的X位置
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setXY

public function setXY(Array pos, [Boolean/Object animate])
设置元素在页面的坐标位置，不管这个元素如何定位。 The元素必须是DOM树中的一部分，才拥有页面坐标（display:none或未加入的elements返回 false）。
参数：
  • pos : Array
    对于新位置（基于页面坐标）包含X & Y [x, y]的值
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

setY

public function setY(Number The, [Boolean/Object animate])
设置元素基于页面坐标的Y位置。元素必须是DOM树中的一部分，才拥有页面坐标（display:none或未加入的elements返回 false）。
参数：
  • The : Number
    元素的Y位置
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

show

public function show([Boolean/Object animate])
显示这个元素 - 使用display mode 来决定用 "display" 抑或 "visibility"。参阅 setVisible。
参数：
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

swallowEvent

public function swallowEvent(String eventName, [Boolean preventDefault])
事件上报（bubbling）的过程中停止特定的事件，可选地阻止默认动作。
参数：
  • eventName : String
  • preventDefault : Boolean
    （可选） 值为 True 时用来防止缺省动作。 too
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

toggle

public function toggle([Boolean/Object animate])
转换元素visibility或display，取决于visibility mode。
参数：
  • animate : Boolean/Object
    （可选）true表示为为默认动画，或有一个标准元素动画配置的对象
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

toggleClass

public function toggleClass(String className)
轮换（Toggles）--添加或移除指定的CSS类（如果已经存在的话便删除，否则就是新增加）。
参数：
  • className : String
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

translatePoints

public function translatePoints(Number/Array x, Number y, Object An)
传入一个页面坐标的参数，将其翻译到元素的CSS left/top值。
参数：
  • x : Number/Array
    页面x or 数组 [x, y]
  • y : Number
    页面 y
  • An : Object
    包含left、top属性的对象，如 {left: (值), top: (值)}
返回：
  • void
这个方法由 Element 对象定义。

unclip

public function unclip()
在调用clip()之前，返回原始的裁剪部分（溢出的）
参数：
  • 无。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

unmask

public function unmask()
移除之前的蒙板。如迸出果removeEl是true，则蒙板会被摧毁，否则放在缓存cache中。
参数：
  • 无。
返回：
  • void
这个方法由 Element 对象定义。

unselectable

public function unselectable()
禁止该元素的文本可被选择（可跨浏览器）。
参数：
  • 无。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

up

public function up(String ss, [Number/String/HTMLElement/Element maxDepth])
传入一个选择符的参数，按照选择符并沿着dom查找父节点。选择符应是简易的选择符，如 div.some-class or span:first-child。
参数：
  • ss : String
    要测试的简易选择符
  • maxDepth : Number/String/HTMLElement/Element
    （可选）搜索深度（MaxDepth），可以为number或元素(默认是 10 || document.body)
返回：
  • Ext.Element
这个方法由 Element 对象定义。

update

public function update(String html, [Boolean loadScripts], Function callback)
更新该元素的innerHTML,遇到脚本可以执行。
参数：
  • html : String
    新的HTML
  • loadScripts : Boolean
    （可选）true表示为遇到脚本要执行
  • callback : Function
    当更新完成后，你加载一个同步脚本，得知更新完成。
返回：
  • Ext.Element
    this
这个方法由 Element 对象定义。

wrap

public function wrap([Object config], [Boolean returnDom])
创建和包裹（warp）该元素和其他元素
参数：
  • config : Object
    （可选）包裹元素（null的话则是一个空白的div）的DomHelper配置项对象
  • returnDom : Boolean
    （可选）true表示为返回没加工过的DOM元素，而非Ext.Element
返回：
  • /HTMLElementElement
    刚创建好的包裹元素
这个方法由 Element 对象定义。
Ext - Copyright © 2006-2007 Ext JS, LLC
All rights reserved.