打印版式

Class Ext.Layer

Package:Ext
Class:Layer
Extends:Element
Defined In:Layer.js
An extended Element object that supports a shadow and shim, constrain to viewport and automatic maintaining of shadow/shim positions.

属性   -  方法   -  事件   -  设置选项

公共属性

属性 定义对象
  defaultUnit : String Element
The default unit to append to CSS values where a unit isn't provided (Defaults to px).
  dom : HTMLElement Element
The DOM element
  id : String Element
The DOM element ID
  originalDisplay : String Element
The element's default display mode

公共方法

方法 定义对象
  Layer(Object config, [String/HTMLElement existingEl]) Layer
  addClass(String/Array className) : Ext.Element Element
Add a CSS class to the element.
  addClassOnClick(String className) : Ext.Element Element
Sets up event handlers to add and remove a css class when the mouse is down and then up on this element (a click effect)
  addClassOnFocus(String className) : Ext.Element Element
Sets up event handlers to add and remove a css class when this element has the focus
  addClassOnOver(String className, [Boolean preventFlicker]) : Ext.Element Element
Sets up event handlers to add and remove a css class when the mouse is over this element
  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位置。
  setZIndex(Number zindex) : this Layer
Set the z-index of this layer and adjusts any shadow and shim z-indexes. The layer z-index is automatically increment...
  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)该元素和其他元素

公共事件

此类没有公共事件。

设置选项

设置选项 定义对象
  cls : String Layer
CSS class to add to the element
  constrain : Boolean Layer
False to disable constrain to viewport (defaults to true)
  dh : Object Layer
DomHelper object config to create element with (defaults to {tag: "div", cls: "x-layer"}).
  shadow : String/Boolean Layer
True to create a shadow element with default class "x-layer-shadow" or you can pass a string with a css class name. F...
  shadowOffset : Number Layer
Number of pixels to offset the shadow (defaults to 3)
  shim : Boolean Layer
False to disable the iframe shim in browsers which need one (defaults to true)
  zindex : Number Layer
Starting z-index (defaults to 11000!)

属性详情

defaultUnit

public String defaultUnit
如不指定CSS值的单位则默认为px。
This property is defined by Element.

dom

public HTMLElement dom
The DOM element
This property is defined by Element.

id

public String id
The DOM element ID
This property is defined by Element.

originalDisplay

public String originalDisplay
The element's default display mode
This property is defined by Element.

构造函数

Layer

public function Layer(Object config, [String/HTMLElement existingEl])
参数:
  • config : Object
  • existingEl : String/HTMLElement
    (可选) Uses an existing dom element. If the element is not found it creates it.

方法详情

addClass

public function addClass(String/Array className)
Add a CSS class to the element.
参数:
  • className : String/Array
    The CSS class to add or an array of classes
返回:
  • Ext.Element
    this
This method is defined by Element.

addClassOnClick

public function addClassOnClick(String className)
Sets up event handlers to add and remove a css class when the mouse is down and then up on this element (a click effect)
参数:
  • className : String
返回:
  • Ext.Element
    this
This method is defined by Element.

addClassOnFocus

public function addClassOnFocus(String className)
Sets up event handlers to add and remove a css class when this element has the focus
参数:
  • className : String
返回:
  • Ext.Element
    this
This method is defined by Element.

addClassOnOver

public function addClassOnOver(String className, [Boolean preventFlicker])
Sets up event handlers to add and remove a css class when the mouse is over this element
参数:
  • className : String
  • preventFlicker : Boolean
    (可选) If set to true, it prevents flickering by filtering mouseout events for children elements
返回:
  • Ext.Element
    this
This method is defined by Element.

addKeyListener

public function addKeyListener(Number/Array/Object/String key, Function fn, [Object scope])
构建KeyMap的快捷方式
参数:
  • key : Number/Array/Object/String
    Either a string with the keys to listen for, the numeric key code, array of key codes or an object with the following options: {key: (number or array), shift: (true/false), ctrl: (true/false), alt: (true/false)}
  • fn : Function
    The function to call
  • scope : Object
    (可选) The scope of the function
返回:
  • Ext.KeyMap
    The KeyMap created
This method is defined by Element.

addKeyMap

public function addKeyMap(Object config)
为该元素创建一个KeyMap
参数:
  • config : Object
    The KeyMap config. See Ext.KeyMap for more details
返回:
  • Ext.KeyMap
    The KeyMap created
This method is defined by Element.

addListener

public function addListener(String eventName, Function fn, [Object scope], [Object options])
加入一个事件处理器
参数:
  • eventName : String
    The type of event to append
  • fn : Function
    事件调用的方法
  • scope : Object
    (可选) The scope (this object) of the fn
  • options : Object
    (可选)An object with standard EventManager options
返回:
  • void
This method is defined by Element.

alignTo

public function alignTo(String/HTMLElement/Ext.Element element, String position, [Array offsets], [Boolean/Object animate])
对齐元素到另外一个元素的指定的标记。 If the other element is the document it aligns it to the viewport. The position parameter is optional, and can be specified in any one of the following formats:
  • 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
This method is defined by 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 to monitor body scroll and reposition. If this parameter is a number, it is used as the buffer delay (defaults to 50ms).
  • :
返回:
  • void
This method is defined by Element.

animate

public function animate(Object args, [Float duration], [Function onComplete], [String easing], [String animType])
在元素上执行动画
参数:
  • args : Object
    The YUI animation control args
  • duration : Float
    (可选) How long the animation lasts. (Defaults to .35 seconds)
  • onComplete : Function
    (可选) Function to call when animation completes.
  • easing : String
    (可选) Easing method to use. (Defaults to 'easeOut')
  • animType : String
    (可选) 'run' is the default. Can be 'color', 'motion', or 'scroll'
返回:
  • Ext.Element
    this
This method is defined by Element.

appendChild

public function appendChild(String/HTMLElement/Array/Element/CompositeElement el)
传入一个或多个元素,加入到该元素
参数:
  • el : String/HTMLElement/Array/Element/CompositeElement
返回:
  • Ext.Element
    this
This method is defined by Element.

appendTo

public function appendTo(String/HTMLElement/Element el)
传入元素的参数,将该元素加入到传入的元素
参数:
  • el : String/HTMLElement/Element
    The new parent element
返回:
  • Ext.Element
    this
This method is defined by Element.

applyStyles

public function applyStyles(String/Object/Function styles)
setStyle的另一个版本,能更灵活地设置样式属性。
参数:
  • styles : String/Object/Function
    A style specification string eg "width:100px", or object in the form {width:"100px"}, or a function which returns such a specification.
返回:
  • Ext.Element
    this
This method is defined by Element.

autoHeight

public function autoHeight([Boolean animate], [Float duration], [Function onComplete], [String easing])
测量元素其内容的实际高度,使元素之高度适合。注:改函数使用setTimeout而且新高度或者不会立即有效。
参数:
  • animate : Boolean
    (可选) Animate the transition (Default is false)
  • duration : Float
    (可选) Length of the animation. (Defaults to .35 seconds)
  • onComplete : Function
    (可选) Function to call when animation completes.
  • easing : String
    (可选) Easing method to use.
返回:
  • Ext.Element
    this
This method is defined by Element.

beginMeasure

public function beginMeasure()
先对元素进行display:none, 然后临时激活偏移(width、height、x、y)。最后使用endMeasure()。
参数:
  • 无。
返回:
  • Ext.Element
    this
This method is defined by Element.

blur

public function blur()
使这个元素失去焦点。忽略任何已捕获的异常。
参数:
  • 无。
返回:
  • Ext.Element
    this
This method is defined by Element.

center

public function center([String/HTMLElement/Ext.Element centerIn])
在视图或其他元素中,居中元素。
参数:
  • centerIn : String/HTMLElement/Ext.Element
    (可选) The element in which to center the element.
返回:
  • void
This method is defined by Element.

child

public function child(String selector, Boolean returnDom)
传入一个CSS选择符的参数,然后基于该选择符和搜索深度,选取单个子节点(选择符不应有id)
参数:
  • selector : String
    The CSS selector
  • returnDom : Boolean
    true to return the DOM node instead of Ext.Element
返回:
  • Element
    The element
This method is defined by Element.

clean

public function clean([Boolean forceReclean])
移除无用的文本节点
参数:
  • forceReclean : Boolean
    (可选) By default the element keeps track if it has been cleaned already so you can call this over and over. However, if you update the element and need to force a reclean, you can pass true.
返回:
  • void
This method is defined by Element.

clearOpacity

public function clearOpacity()
清除这个元素的透明度设置。IE有时候会用到
参数:
  • 无。
返回:
  • Ext.Element
    this
This method is defined by Element.

clearPositioning

public function clearPositioning([String value])
当文档加载后清除位置并复位到默认
参数:
  • value : String
    (可选) The value to use for the left,right,top,bottom, defaults to '' (empty string). You could use 'auto'.
返回:
  • Ext.Element
    this
This method is defined by Element.

clip

public function clip()
保存当前的溢出(overflow),然后进行裁剪元素的溢出部分 - 使用 unclip 来移除
参数:
  • 无。
返回:
  • Ext.Element
    this
This method is defined by Element.

contains

public function contains(HTMLElement/String el)
返回true,如果这个元素是传入元素的父辈元素
参数:
  • el : HTMLElement/String
返回:
  • Boolean
This method is defined by 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 element config object
  • insertBefore : HTMLElement
    (可选) a child element of this element
  • returnDom : Boolean
    (可选) true to return the dom node instead of creating an Element
返回:
  • Ext.Element
    The new child element
This method is defined by Element.

createProxy

public function createProxy(String/Object config, [String/HTMLElement renderTo], [Boolean matchBox])
创建元素的代理
参数:
  • config : String/Object
    The class name of the proxy element or a DomHelper config object
  • renderTo : String/HTMLElement
    (可选) The element or element id to render the proxy to (defaults to document.body)
  • matchBox : Boolean
    (可选) True to align and size the proxy to this element now (defaults to false)
返回:
  • Ext.Element
    The new proxy element
This method is defined by Element.

createShim

public function createShim()
创建一个iframe垫片来使得select和其他windowed对象在该元素显示之下。
参数:
  • 无。
返回:
  • Ext.Element
    The new shim element
This method is defined by Element.

down

public function down(String selector, Boolean returnDom)
传入一个CSS选择符的参数,然后基于该选择符和搜索深度,"直接"选取单个子节点(选择符不应有id)
参数:
  • selector : String
    The CSS selector
  • returnDom : Boolean
    true to return the DOM node instead of Ext.Element
返回:
  • Element
    The element
This method is defined by Element.

enableDisplayMode

public function enableDisplayMode([String display])
setVisibilityMode(Element.DISPLAY)快捷方式
参数:
  • display : String
    (可选) What to set display to when visible
返回:
  • Ext.Element
    this
This method is defined by Element.

endMeasure

public function endMeasure()
在调用beginMeasure()之后恢复显示
参数:
  • 无。
返回:
  • Ext.Element
    this
This method is defined by Element.

findParent

public function findParent(String ss, [Number/String/HTMLElement/Element maxDepth], [Boolean returnEl])
Looks at this node and then at parent nodes for a match of the passed simple selector (e.g. div.some-class or span:first-child)
参数:
  • ss : String
    The simple selector to test
  • maxDepth : Number/String/HTMLElement/Element
    (可选) The max depth to search as a number or element (defaults to 10 || document.body)
  • returnEl : Boolean
    (可选) True to return a Ext.Element object instead of DOM node
返回:
  • HTMLElement
This method is defined by Element.

findParentNode

public function findParentNode(String ss, [Number/String/HTMLElement/Element maxDepth], [Boolean returnEl])
传入一个选择符的参数,按照选择符查找父节点。选择符应是简易的选择符,如 div.some-class 或者 span:first-child。
参数:
  • ss : String
    The simple selector to test
  • maxDepth : Number/String/HTMLElement/Element
    (可选) The max depth to search as a number or element (defaults to 10 || document.body)
  • returnEl : Boolean
    (可选) True to return a Ext.Element object instead of DOM node
返回:
  • HTMLElement
This method is defined by Element.

fitToParent

public function fitToParent([Boolean monitorResize], [String/HTMLElment/Element targetParent])
调整该元素的大小,以适合父元素尺寸。需执行 box adjustments
参数:
  • monitorResize : Boolean
    (可选) If true maintains the fit when the browser window is resized.
  • targetParent : String/HTMLElment/Element
    (可选) The target parent, default to the parentNode.
返回:
  • Ext.Element
    this
This method is defined by Element.

focus

public function focus()
使这个元素得到焦点。忽略任何已捕获的异常。
参数:
  • 无。
返回:
  • Ext.Element
    this
This method is defined by 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]
This method is defined by Element.

getAnchorXY

public function getAnchorXY([String anchor], [Object size], [Boolean local])
返回X、Y坐标,由元素已标记好的位置(anchor position)指定。
参数:
  • anchor : String
    (可选)指定的标记位置(默认为 "c")。 See alignTo for details on supported anchor positions.
  • size : Object
    (可选) An object containing the size to use for calculating anchor position {width: (target width), height: (target height)} (defaults to the element's current size)
  • local : Boolean
    (可选) True to get the local (element top/left-relative) anchor position instead of page coordinates
返回:
  • Array
    [x, y] An array containing the element's x and y coordinates
This method is defined by Element.

getBorderWidth

public function getBorderWidth(String side)
获取指定边的边框宽度
参数:
  • side : String
    Can be t, l, r, b or any combination of those to add multiple values. For example, passing lr would get the border (l)eft width + the border (r)ight width.
返回:
  • Number
    The width of the sides passed added together
This method is defined by Element.

getBottom

public function getBottom(Boolean local)
获取元素的底部Y坐标 (元素Y位置 + 元素宽度)
参数:
  • local : Boolean
    True to get the local css position instead of page coordinate
返回:
  • Number
This method is defined by Element.

getBox

public function getBox([Boolean contentBox], [Boolean local])
返回一个BOX {x, y, width, height},可用于匹配其他元素的大小/位置。
参数:
  • contentBox : Boolean
    (可选) If true a box for the content of the element is returned.
  • local : Boolean
    (可选) If true the element's left and top are returned instead of page x/y.
返回:
  • Object
This method is defined by Element.

getCenterXY

public function getCenterXY()
计算该元素的x,y到屏幕中心的值
参数:
  • 无。
返回:
  • Array
    The x, y values [x, y]
This method is defined by Element.

getColor

public function getColor(String attr, String defaultValue, [String prefix])
为指定的CSS属性返回CSS颜色。RGB、三位数(像#fff)和有效值都被转换到标准六位十六进制的颜色
参数:
  • attr : String
    The css attribute
  • defaultValue : String
    The default value to use when a valid color isn't found
  • prefix : String
    (可选) defaults to #. Use an empty string when working with YUI color anims.
返回:
  • void
This method is defined by 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
This method is defined by 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
This method is defined by Element.

getFrameWidth

public function getFrameWidth(String sides)
传入的“side”的参数,统计边框和内补丁(padding & borders)的宽度并返回该值。 See getBorderWidth() for more information about the sides.
参数:
  • sides : String
返回:
  • Number
This method is defined by Element.

getHeight

public function getHeight([Boolean contentHeight])
返回元素的偏移(offset)高度
参数:
  • contentHeight : Boolean
    (可选) true to get the height minus borders and padding
返回:
  • Number
    The element's height
This method is defined by Element.

getLeft

public function getLeft(Boolean local)
获取X坐标
参数:
  • local : Boolean
    True to get the local css position instead of page coordinate
返回:
  • Number
This method is defined by Element.

getMargins

public function getMargins([String sides])
Returns an object with properties top, left, right and bottom representing the margins of this element unless sides is passed, then it returns the calculated width of the sides (see getPadding)
参数:
  • sides : String
    (可选) Any combination of l, r, t, b to get the sum of those sides
返回:
  • Object/Number
This method is defined by Element.

getNextSibling

public function getNextSibling()
获取下一个兄弟节点,跳过文本节点。
参数:
  • 无。
返回:
  • HTMLElement
    The next sibling or null
This method is defined by Element.

getPadding

public function getPadding(String side)
获取指定边的padding宽度
参数:
  • side : String
    Can be t, l, r, b or any combination of those to add multiple values. For example, passing lr would get the padding (l)eft + the padding (r)ight.
返回:
  • Number
    The padding of the sides passed added together
This method is defined by Element.

getPositioning

public function getPositioning()
获取一个包含CSS定位的对象。有用的技巧:连同setPostioning一起,可在更新执行之前,先做一个快照(snapshot),之后便可恢复该元素。
参数:
  • 无。
返回:
  • Object
This method is defined by Element.

getPrevSibling

public function getPrevSibling()
获取前一个兄弟节点,跳过文本节点。
参数:
  • 无。
返回:
  • HTMLElement
    The previous sibling or null
This method is defined by Element.

getRegion

public function getRegion()
返回给出元素的区域。元素必须是DOM树中的一部分,才拥有页面坐标(display:none或未加入的elements返回 false)。
参数:
  • 无。
返回:
  • Region
    A Ext.lib.Region containing "top, left, bottom, right" member data.
This method is defined by Element.

getRight

public function getRight(Boolean local)
获取元素的右X坐标 (元素X位置 + 元素宽度)
参数:
  • local : Boolean
    True to get the local css position instead of page coordinate
返回:
  • Number
This method is defined by Element.

getSize

public function getSize([Boolean contentSize])
返回元素尺寸大小。
参数:
  • contentSize : Boolean
    (可选) true to get the width/size minus borders and padding
返回:
  • Object
    An object containing the element's size {width: (element width), height: (element height)}
This method is defined by Element.

getStyle

public function getStyle(String property)
常规化当前样式和计算样式。这并不是YUI的getStyle,是一个已优化的版本。
参数:
  • property : String
    The style property whose value is returned.
返回:
  • String
    The current value of the style property for this element.
This method is defined by 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
This method is defined by Element.

getTop

public function getTop(Boolean local)
获取顶部Y坐标
参数:
  • local : Boolean
    True to get the local css position instead of page coordinate
返回:
  • Number
This method is defined by Element.

getUpdateManager

public function getUpdateManager()
获取这个元素的UpdateManager
参数:
  • 无。
返回:
  • Ext.UpdateManager
    The UpdateManager
This method is defined by Element.

getValue

public function getValue(Boolean asNumber)
返回“value”属性的值
参数:
  • asNumber : Boolean
    true to parse the value as a number
返回:
  • String/Number
This method is defined by Element.

getWidth

public function getWidth([Boolean contentWidth])
返回元素的偏移(offset)宽度
参数:
  • contentWidth : Boolean
    (可选) true to get the width minus borders and padding
返回:
  • Number
    The element's width
This method is defined by Element.

getX

public function getX()
获取元素基于页面坐标的X位置。元素必须是DOM树中的一部分,才拥有页面坐标(display:none或未加入的elements返回 false)。
参数:
  • 无。
返回:
  • Number
    元素的X位置
This method is defined by Element.

getXY

public function getXY()
获取元素基于页面坐标当前的位置。元素必须是DOM树中的一部分,才拥有页面坐标(display:none或未加入的elements返回 false)。
参数:
  • 无。
返回:
  • Array
    元素的XY位置
This method is defined by Element.

getY

public function getY()
获取元素基于页面坐标的Y位置。元素必须是DOM树中的一部分,才拥有页面坐标(display:none或未加入的elements返回 false)。
参数:
  • 无。
返回:
  • Number
    元素的Y位置
This method is defined by Element.

hasClass

public function hasClass(String className)
检查某个CSS类是否存在这个元素的DOM节点上。
参数:
  • className : String
    要检查CSS类
返回:
  • Boolean
    true or false
This method is defined by Element.

hide

public function hide([Boolean/Object animate])
隐藏这个元素, 使用display mode 来决定用 "display" 抑或 "visibility"。参阅 setVisible
参数:
  • animate : Boolean/Object
    (可选)true表示为为默认动画,或有一个标准元素动画配置的对象
返回:
  • Ext.Element
    this
This method is defined by 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对象
This method is defined by 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对象
This method is defined by 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对象
This method is defined by Element.

insertAfter

public function insertAfter(String/HTMLElement/Element el)
传入元素的参数,将该元素的DOM插入其之后
参数:
  • el : String/HTMLElement/Element
    The element to insert after
返回:
  • Ext.Element
    this
This method is defined by Element.

insertBefore

public function insertBefore(String/HTMLElement/Element el)
传入元素的参数,将该元素的DOM插入其之前
参数:
  • el : String/HTMLElement/Element
    The element to insert before
返回:
  • Ext.Element
    this
This method is defined by Element.

insertFirst

public function insertFirst(String/HTMLElement/Element/Object el)
插入(或创建)一个元素(或DomHelper配置项对象)作为该元素的第一个子元素
参数:
  • el : String/HTMLElement/Element/Object
    The id or element to insert or a DomHelper config to create and insert
返回:
  • Ext.Element
    The new child
This method is defined by Element.

insertHtml

public function insertHtml(String where, String html)
插入HTML片断到这个元素
参数:
  • where : String
    Where to insert the html in relation to the this element - beforeBegin, afterBegin, beforeEnd, afterEnd.
  • html : String
    The HTML fragment
返回:
  • HTMLElement
    The inserted node (or nearest related if more than 1 inserted)
This method is defined by Element.

insertSibling

public function insertSibling(String/HTMLElement/Element/Object el, [String where], [Boolean returnDom])
插入(或创建)一个元素(或DomHelper配置项对象)作为该元素的兄弟节点。
参数:
  • el : String/HTMLElement/Element/Object
    The id or element to insert or a DomHelper config to create and insert
  • where : String
    (可选) 'before' or 'after' defaults to before
  • returnDom : Boolean
    (可选) True to return the raw DOM element instead of Ext.Element
返回:
  • Ext.Element
    the inserted Element
This method is defined by Element.

is

public function is(String ss)
返回true,如果这个元素就是传入的简易选择符参数(如 div.some-class或span:first-child)
参数:
  • ss : String
    The simple selector to test
返回:
  • Boolean
This method is defined by Element.

isBorderBox

public function isBorderBox()
测试不同的CSS规则/浏览器以确定该元素是否使用Border Box
参数:
  • 无。
返回:
  • Boolean
This method is defined by Element.

isDisplayed

public function isDisplayed()
如果属性display不是"none"就返回true
参数:
  • 无。
返回:
  • Boolean
This method is defined by Element.

isMasked

public function isMasked()
返回true表示为这个元素应用了蒙板。
参数:
  • 无。
返回:
  • Boolean
This method is defined by Element.

isScrollable

public function isScrollable()
返回true表示为该元素是可滚动的
参数:
  • 无。
返回:
  • Boolean
This method is defined by Element.

isVisible

public function isVisible(Boolean deep)
检查当前该元素是否都使用属性visibility和属性display来显示。
参数:
  • deep : Boolean
    True to walk the dom and see if parent elements are hidden.
返回:
  • Boolean
    true if the element is currently visible
This method is defined by Element.

load

public function load(String/Function url, [String/Object params], [Function callback], [Boolean discardUrl])
直接访问UpdateManager update() 的方法(使用相同的参数)
参数:
  • url : String/Function
    The url for this request or a function to call to get the url
  • params : String/Object
    (可选) The parameters to pass as either a url encoded string "param1=1&param2=2" or an object {param1: 1, param2: 2}
  • callback : Function
    (可选) Callback when transaction is complete - called with signature (oElement, bSuccess)
  • discardUrl : Boolean
    (可选) By default when you execute an update the defaultUrl is changed to the last used url. If true, it will not store the url.
返回:
  • Ext.Element
    this
This method is defined by Element.

mask

public function mask([String msg], [String msgCls])
在元素身上遮上一个蒙板(mask),以禁止用户操作。须core.css。 This method can only be applied to elements which accept child nodes.
参数:
  • msg : String
    (可选) A message to display in the mask
  • msgCls : String
    (可选) A css class to apply to the msg element
返回:
  • Element
    The message element
This method is defined by 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
    How far to move the element in pixels
  • animate : Boolean/Object
    (可选)true表示为为默认动画,或有一个标准元素动画配置的对象
返回:
  • Ext.Element
    this
This method is defined by 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
This method is defined by Element.

position

public function position([String pos], [Number zIndex], [Number x], [Number y])
初始化元素的定位。如果不传入一个特定的定位,而又还没定位的话,将会使这个元素 相对(relative)定位
参数:
  • pos : String
    (可选) Positioning to use "relative", "absolute" or "fixed"
  • zIndex : Number
    (可选) The zIndex to apply
  • x : Number
    (可选) Set the page X position
  • y : Number
    (可选) Set the page Y position
返回:
  • void
This method is defined by Element.

query

public function query(String selector)
传入一个CSS选择符的参数,然后基于该选择符选取其子节点(选择符不应有id)
参数:
  • selector : String
    The CSS selector
返回:
  • Array
    An array of the matched nodes
This method is defined by Element.

radioClass

public function radioClass(String className)
添加一个或多个className到这个元素,并移除其兄弟(siblings)所有的样式。
参数:
  • className : String
    The className to add
返回:
  • Ext.Element
    this
This method is defined by Element.

remove

public function remove()
从DOM里面移除该元素,并从缓存中删除。
参数:
  • 无。
返回:
  • void
This method is defined by Element.

removeAllListeners

public function removeAllListeners()
在该元素身上移除所有已加入的侦听器
参数:
  • 无。
返回:
  • Ext.Element
    this
This method is defined by Element.

removeClass

public function removeClass(String/Array className)
移除元素的CSS类
参数:
  • className : String/Array
    The CSS class to remove or an array of classes
返回:
  • Ext.Element
    this
This method is defined by Element.

removeListener

public function removeListener(String eventName, Function fn)
从这个元素上移除一个事件处理器(event handler)
参数:
  • eventName : String
    要移除事件的类型
  • fn : Function
    事件调用的方法
返回:
  • Ext.Element
    this
This method is defined by Element.

repaint

public function repaint()
强制浏览器重新渲染该元素
参数:
  • 无。
返回:
  • Ext.Element
    this
This method is defined by Element.

replace

public function replace(String/HTMLElement/Element el)
用这个元素替换掉传入的元素
参数:
  • el : String/HTMLElement/Element
    The element to replace
返回:
  • Ext.Element
    this
This method is defined by Element.

replaceClass

public function replaceClass(String oldClassName, String newClassName)
在这个元素身上替换CSS类。
参数:
  • oldClassName : String
    The CSS class to replace
  • newClassName : String
    The replacement CSS class
返回:
  • Ext.Element
    this
This method is defined by 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表示为元素能滚动其最远的
This method is defined by Element.

scrollIntoView

public function scrollIntoView([String/HTMLElement/Element container], [Boolean hscroll])
传入一个容器(container)参数,把元素滚动到容器的视图(View)。
参数:
  • container : String/HTMLElement/Element
    (可选) The container element to scroll (defaults to document.body)
  • hscroll : Boolean
    (可选) false to disable horizontal scroll
返回:
  • Ext.Element
    this
This method is defined by 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
This method is defined by Element.

select

public function select(String selector, Boolean unique)
传入一个CSS选择符的参数,然后基于该选择符的子节点(Child nodes)创建一个 Ext.CompositeElement 组合元素。(选择符不应有id)
参数:
  • selector : String
    The CSS selector
  • unique : Boolean
    true:为每个子元素创建独一无二的 Ext.Element(默认为false享元的普通对象flyweight object)
返回:
  • CompositeElement/CompositeElementLite
    The composite element
This method is defined by Element.

set

public function set(Object o, [Boolean useSet])
传入属性(attributes)的参数,使之成为该元素的属性(一个样式的属性可以是字符串,对象或函数function)
参数:
  • o : Object
    The object with the attributes
  • useSet : Boolean
    (可选) false to override the default setAttribute to use expandos.
返回:
  • Ext.Element
    this
This method is defined by Element.

setBottom

public function setBottom(String bottom)
设置元素CSS Bottom的样式
参数:
  • bottom : String
    The bottom CSS property value
返回:
  • Ext.Element
    this
This method is defined by 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
This method is defined by 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
This method is defined by Element.

setDisplayed

public function setDisplayed(Boolean value)
设置css display。如果value为true,则使用originalDisplay。
参数:
  • value : Boolean
    Boolean to display the element using its default display or a string to set the display directly
返回:
  • Ext.Element
    this
This method is defined by Element.

setHeight

public function setHeight(Number height, [Boolean/Object animate])
设置元素的高度
参数:
  • height : Number
    新高度
  • animate : Boolean/Object
    (可选)true表示为为默认动画,或有一个标准元素动画配置的对象
返回:
  • Ext.Element
    this
This method is defined by Element.

setLeft

public function setLeft(String left)
直接使用CSS样式(代替 setX),设定元素的left位置。
参数:
  • left : String
    The left CSS property value
返回:
  • Ext.Element
    this
This method is defined by Element.

setLeftTop

public function setLeftTop()
快速设置left和top(带默认单位)
参数:
  • 无。
返回:
  • Ext.Element
    this
This method is defined by 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
This method is defined by Element.

setOpacity

public function setOpacity(Float opacity, [Boolean/Object animate])
设置元素透明度
参数:
  • opacity : Float
    The new opacity. 0 = transparent, .5 = 50% visibile, 1 = fully visible, etc
  • animate : Boolean/Object
    (可选)true表示为为默认动画,或有一个标准元素动画配置的对象
返回:
  • Ext.Element
    this
This method is defined by Element.

setPositioning

public function setPositioning(Object posCfg)
由getPositioning()返回的对象去设置定位。
参数:
  • posCfg : Object
返回:
  • Ext.Element
    this
This method is defined by Element.

setRegion

public function setRegion(Ext.lib.Region region, [Boolean/Object animate])
设置元素的位置并调整大小到指定的位置。如果动画效果被打开,高度和宽度都会产生动画的变化效果。
参数:
  • region : Ext.lib.Region
    The region to fill
  • animate : Boolean/Object
    (可选)true表示为为默认动画,或有一个标准元素动画配置的对象
返回:
  • Ext.Element
    this
This method is defined by Element.

setRight

public function setRight(String right)
设置元素CSS Right的样式
参数:
  • right : String
    The right CSS property value
返回:
  • Ext.Element
    this
This method is defined by Element.

setSize

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

setStyle

public function setStyle(String/Object property, [String val])
设置样式属性的包裹器,也可以用一个对象参数包含多个样式。
参数:
  • property : String/Object
    The style property to be set or an object of multiple styles.
  • val : String
    (可选) The value to apply to the given property or null if an object was passed.
返回:
  • Ext.Element
    this
This method is defined by Element.

setTop

public function setTop(String top)
直接使用CSS样式(代替 setY),设定元素的top位置。
参数:
  • top : String
    The top CSS property value
返回:
  • Ext.Element
    this
This method is defined by Element.

setVisibilityMode

public function setVisibilityMode(visMode Element.VISIBILITY)
设置元素的可见模式。当调用setVisible()时,会确定可见模式究竟是“visibility”的还是“display”的。
参数:
  • Element.VISIBILITY : visMode
    or Element.DISPLAY
返回:
  • Ext.Element
    this
This method is defined by Element.

setVisible

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

setWidth

public function setWidth(Number width, [Boolean/Object animate])
设置元素的宽度
参数:
  • width : Number
    新宽度
  • animate : Boolean/Object
    (可选)true表示为为默认动画,或有一个标准元素动画配置的对象
返回:
  • Ext.Element
    this
This method is defined by 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
This method is defined by Element.

setXY

public function setXY(Array pos, [Boolean/Object animate])
设置元素在页面的坐标位置,不管这个元素如何定位。 The元素必须是DOM树中的一部分,才拥有页面坐标(display:none或未加入的elements返回 false)。
参数:
  • pos : Array
    Contains X & Y [x, y] values for new position (coordinates are page-based)
  • animate : Boolean/Object
    (可选)true表示为为默认动画,或有一个标准元素动画配置的对象
返回:
  • Ext.Element
    this
This method is defined by Element.

setY

public function setY(Number The, [Boolean/Object animate])
设置元素基于页面坐标的Y位置。元素必须是DOM树中的一部分,才拥有页面坐标(display:none或未加入的elements返回 false)。
参数:
  • The : Number
    Y position of the element
  • animate : Boolean/Object
    (可选)true表示为为默认动画,或有一个标准元素动画配置的对象
返回:
  • Ext.Element
    this
This method is defined by Element.

setZIndex

public function setZIndex(Number zindex)
Set the z-index of this layer and adjusts any shadow and shim z-indexes. The layer z-index is automatically incremented by two more than the value passed in so that it always shows above any shadow or shim (the shadow element, if any, will be assigned z-index + 1, and the shim element, if any, will be assigned the unmodified z-index).
参数:
  • zindex : Number
    The new z-index to set
返回:
  • this
    The Layer
This method is defined by Layer.

show

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

swallowEvent

public function swallowEvent(String eventName, [Boolean preventDefault])
事件上报(bubbling)的过程中停止特定的事件,可选地阻止默认动作。
参数:
  • eventName : String
  • preventDefault : Boolean
    (可选) 值为 True 时用来防止缺省动作。 too
返回:
  • Ext.Element
    this
This method is defined by Element.

toggle

public function toggle([Boolean/Object animate])
转换元素visibility或display,取决于visibility mode。
参数:
  • animate : Boolean/Object
    (可选)true表示为为默认动画,或有一个标准元素动画配置的对象
返回:
  • Ext.Element
    this
This method is defined by Element.

toggleClass

public function toggleClass(String className)
轮换(Toggles)--添加或移除指定的CSS类(如果已经存在的话便删除,否则就是新增加)。
参数:
  • className : String
返回:
  • Ext.Element
    this
This method is defined by Element.

translatePoints

public function translatePoints(Number/Array x, Number y, Object An)
传入一个页面坐标的参数,将其翻译到元素的CSS left/top值。
参数:
  • x : Number/Array
    The page x or an array containing [x, y]
  • y : Number
    The page y
  • An : Object
    object with left and top properties. e.g. {left: (value), top: (value)}
返回:
  • void
This method is defined by Element.

unclip

public function unclip()
在调用clip()之前,返回原始的裁剪部分(溢出的)
参数:
  • 无。
返回:
  • Ext.Element
    this
This method is defined by Element.

unmask

public function unmask()
移除之前的蒙板。如果removeEl是true,则蒙板会被摧毁,否则放在缓存cache中。
参数:
  • 无。
返回:
  • void
This method is defined by Element.

unselectable

public function unselectable()
禁止该元素的文本可被选择(可跨浏览器)。
参数:
  • 无。
返回:
  • Ext.Element
    this
This method is defined by Element.

up

public function up(String ss, [Number/String/HTMLElement/Element maxDepth])
传入一个选择符的参数,按照选择符并沿着dom查找父节点。选择符应是简易的选择符,如 div.some-class or span:first-child。
参数:
  • ss : String
    The simple selector to test
  • maxDepth : Number/String/HTMLElement/Element
    (可选) The max depth to search as a number or element (defaults to 10 || document.body)
返回:
  • Ext.Element
This method is defined by Element.

update

public function update(String html, [Boolean loadScripts], Function callback)
更新该元素的innerHTML,遇到脚本可以执行。
参数:
  • html : String
    The new HTML
  • loadScripts : Boolean
    (可选) true to look for and process scripts
  • callback : Function
    For async script loading you can be noticed when the update completes
返回:
  • Ext.Element
    this
This method is defined by Element.

wrap

public function wrap([Object config], [Boolean returnDom])
创建和包裹(warp)该元素和其他元素
参数:
  • config : Object
    (可选)包裹元素(null的话则是一个空白的div)的DomHelper配置项对象
  • returnDom : Boolean
    (可选) True to return the raw DOM element instead of Ext.Element
返回:
  • /HTMLElementElement
    The newly created wrapper element
This method is defined by Element.

设置详情

cls

cls : String
CSS class to add to the element
This config option is defined by Layer.

constrain

constrain : Boolean
False to disable constrain to viewport (defaults to true)
This config option is defined by Layer.

dh

dh : Object
DomHelper object config to create element with (defaults to {tag: "div", cls: "x-layer"}).
This config option is defined by Layer.

shadow

shadow : String/Boolean
True to create a shadow element with default class "x-layer-shadow" or you can pass a string with a css class name. False turns off the shadow.
This config option is defined by Layer.

shadowOffset

shadowOffset : Number
Number of pixels to offset the shadow (defaults to 3)
This config option is defined by Layer.

shim

shim : Boolean
False to disable the iframe shim in browsers which need one (defaults to true)
This config option is defined by Layer.

zindex

zindex : Number
Starting z-index (defaults to 11000!)
This config option is defined by Layer.

Ext - Copyright © 2006-2007 Ext JS, LLC
All rights reserved.