打印版式

Class Ext

Package: Global
Class: Ext
Extends: Object
Defined In: Ext.js
Ext 核心工具和函数

该类属于单态类（Singleton），无法直接创建。

属性  -  方法  -  事件

公共属性

属性 定义对象
  BLANK_IMAGE_URL : String Ext
指定一个 1x1 大小的 gif 透明图片的地址，让 CSS 用来做为创建的内联图标的背景。
  SSL_SECURE_URL : String Ext
指定一个指向空白文件的地址，让 Ext 在安全模式下用来填充“iframe”和“onReady”的 src 属性，以避免 IE 的不安全内容警告。
  isReady : Boolean Ext
当值为“true”时表示“document”对象已经完全初始化。
  isSecure : Boolean Ext
当值为“true”时表示当前网页通过 SSL 安全协议访问。
  isStrict : Boolean Ext
当值为“true”时表示浏览器处于“strict”模式。
  useShims : Boolean Ext
Ext 自动决定浮动元素是否应该被填充。

公共方法

方法 定义对象
  addBehaviors(Object obj) : void Ext
当文档准备好后，将事件监听器添加在由选择器选定的元素上。
  apply(Object obj, Object config, Object defaults) : Object Ext
*将“config”对象的所有属性复制到“obj”对象上。
  applyIf(Object obj, Object config) : Object Ext
将“config”对象所有属性中“obj”对象所有没有的属性复制到“obj”对象上。
  decode() : void Ext
Ext.util.JSON.decode方法的缩写。
  each(Array/NodeList/Mixed array, Function fn, Object scope) : void Ext
循环迭代数组中的每一个对象，执行指定的函数，当函数返回“false”时停止。
  encode() : void Ext
Ext.util.JSON.encode方法的缩写。
  escapeRe(String str) : String Ext
将指定的字符转为正则表达式。
  extend(Object subclass, Object superclass, [Object overrides]) : void Ext
“subclass”类继承“superclass”类，并可根据指定的“overrides”覆盖父类成员。
  fly(String/HTMLElement el, [String named]) : Element Ext
<static> 返回全局共享的享元元素，并将指定的节点做为活动元素。
  get(String/HTMLElement/Element el) : Element Ext
检索元素对象的静态方法。
  getCmp(String id) : Ext.Component Ext
Ext.ComponentMgr.get方法的缩写。
  getDom(String/HTMLElement/Element) el) : HTMLElement Ext
返回指定的 Dom 元素。
  id([String/HTMLElement/Element el], [String prefix]) : void Ext
生成一个唯一的ID。
  namespace(String namespace1, String namespace2, String etc) : void Ext
创建命名空间并不假定“YAHOO”为根。
  onReady(Function fn, Object scope, boolean override) : void Ext
当“document”对象准备好后执行指定函数（在“onload”事件与图片加载之前）。
  query(String path, [Node root]) : Array Ext
选择一个由 CSS/XPath 选择器选定的 DOM 节点数组。
  select(String/Array selector, [Boolean unique]) : CompositeElementLite/CompositeElement Ext
选择一个由 CSS 选择器选定的元素。
  urlDecode(String string, [Boolean overwrite]) : Object Ext
将指定的 URL 地址解码并将其转换为一个对象。
  urlEncode(Object o) : String Ext
将指定的对象转换为经过编码的 URL。

公共事件

此类没有公共事件。

属性详情

BLANK_IMAGE_URL

public String BLANK_IMAGE_URL
指定一个 1x1 大小的 gif 透明图片的地址，让 CSS 用来做为创建的内联图标的背景。（默认为“http://extjs.com/s.gif”，你可以将其改为你自己服务器上的文件。）
这个属性由 Ext 对象定义。

SSL_SECURE_URL

public String SSL_SECURE_URL
指定一个指向空白文件的地址，让 Ext 在安全模式下用来填充“iframe”和“onReady”的 src 属性，以避免 IE 的不安全内容警告（默认为“javascript:false”）。
这个属性由 Ext 对象定义。

isReady

public Boolean isReady
当值为“true”时表示“document”对象已经完全初始化。
这个属性由 Ext 对象定义。

isSecure

public Boolean isSecure
当值为“true”时表示当前网页通过 SSL 安全协议访问。
这个属性由 Ext 对象定义。

isStrict

public Boolean isStrict
当值为“true”时表示浏览器处于“strict”模式。
这个属性由 Ext 对象定义。

useShims

public Boolean useShims
Ext 自动决定浮动元素是否应该被填充。如果你要使用 Flash，你就需要将这个属性设置为“true”。
这个属性由 Ext 对象定义。

方法详情

addBehaviors

public function addBehaviors(Object obj)
当文档准备好后，将事件监听器添加在由选择器选定的元素上。事件名称被指定以“@”为后缀。 
Ext.addBehaviors({
   // 给所有 ID 为“foo”的元素添加一个单击事件监听器
   '#foo a@click' : function(e, t){
       // 实际代码
   },

   // 给多个元素添加一样的事件监听器（元素由“@”符号之前的“,”分割）
   '#foo a, #bar span.some-class@mouseover' : function(){
       // 实际代码
   }
});
参数：
  • obj : Object
    The list of behaviors to apply
返回：
  • void
这个方法由 Ext 对象定义。

apply

public function apply(Object obj, Object config, Object defaults)
* Copies all the properties of config to obj.
参数：
  • obj : Object
    目标对象
  • config : Object
    来源对象
  • defaults : Object
    被应用为缺省值的另一个对象
返回：
  • Object
    返回目标对象
这个方法由 Ext 对象定义。

applyIf

public function applyIf(Object obj, Object config)
将“config”对象所有属性中“obj”对象所有没有的属性复制到“obj”对象上。
参数：
  • obj : Object
    目标对象
  • config : Object
    来源对象
返回：
  • Object
    返回目标对象
这个方法由 Ext 对象定义。

decode

public function decode()
Ext.util.JSON.decode方法的缩写。
参数：
  • 无。
返回：
  • void
这个方法由 Ext 对象定义。

each

public function each(Array/NodeList/Mixed array, Function fn, Object scope)
循环迭代数组中的每一个对象，当函数返回“false”时停止。如果指定的对象不是一个数组，指定的函数只执行一次。执行指定的函数时将携带这些参数(Object item, Number index, Array allItems)。
参数：
  • array : Array/NodeList/Mixed
  • fn : Function
  • scope : Object
返回：
  • void
这个方法由 Ext 对象定义。

encode

public function encode()
Ext.util.JSON.encode方法的缩写。
参数：
  • 无。
返回：
  • void
这个方法由 Ext 对象定义。

escapeRe

public function escapeRe(String str)
将指定的字符转为正则表达式。
参数：
  • str : String
返回：
  • String
这个方法由 Ext 对象定义。

extend

public function extend(Object subclass, Object superclass, [Object overrides])
“subclass”类继承“superclass”类，并可根据指定的“overrides”覆盖父类成员。该类也将添加一个“override()”函数用来覆盖实例中的成员。
参数：
  • subclass : Object
    目标类
  • superclass : Object
    被继承类
  • overrides : Object
    （可选）直接量成员
返回：
  • void
这个方法由 Ext 对象定义。

fly

public function fly(String/HTMLElement el, [String named])
<static> 返回全局共享的享元元素，并将指定的节点做为活动元素。不要通过地址保存一个元素——因为 Dom 节点有可能会被其他代码覆盖。Ext.Element.fly方法的缩写。
参数：
  • el : String/HTMLElement
    Dom 节点或ID
  • named : String
    （可选） 指定享元元素的名称以避免冲突（例如“internally”在 Ext 中为 “_internal”）
返回：
  • Element
    共享的享元元素
这个方法由 Ext 对象定义。

get

public function get(String/HTMLElement/Element el)
检索元素对象的静态方法。使用了简单缓存始终返回同一对象。自动修复通过 AJAX 或 Dom 重复创建的对象。Ext.Element.get方法的缩写。
参数：
  • el : String/HTMLElement/Element
    节点的ID、Dom节点或存在的元素。
返回：
  • Element
    元素对象
这个方法由 Ext 对象定义。

getCmp

public function getCmp(String id)
Ext.ComponentMgr.get方法的缩写。
参数：
  • id : String
返回：
  • Ext.Component
这个方法由 Ext 对象定义。

getDom

public function getDom(String/HTMLElement/Element) el)
返回根据指定ID、Dom节点或Ext.Element得到的 Dom 节点。
参数：
  • el : String/HTMLElement/Element)
返回：
  • HTMLElement
这个方法由 Ext 对象定义。

id

public function id([String/HTMLElement/Element el], [String prefix])
Generates unique ids. If the element already has an id, it is unchanged
参数：
  • el : String/HTMLElement/Element
    （可选）要生成ID的元素
  • prefix : String
    （可选）ID的前缀（默认为“ext-gen”）
返回：
  • void
这个方法由 Ext 对象定义。

namespace

public function namespace(String namespace1, String namespace2, String etc)
创建命名空间并不假定“YAHOO”为根。
参数：
  • namespace1 : String
  • namespace2 : String
  • etc : String
返回：
  • void
这个方法由 Ext 对象定义。

onReady

public function onReady(Function fn, Object scope, boolean override)
当“document”对象准备好后执行指定函数（在“onload”事件与图片加载之前）。Ext.EventManager.onDocumentReady方法的缩写。
参数：
  • fn : Function
    调用的方法
  • scope : Object
    作用域对象
  • override : boolean
    为真时，指定的作用域对象将成为监听器的作用域
返回：
  • void
这个方法由 Ext 对象定义。

query

public function query(String path, [Node root])
选择一个由 CSS/XPath 选择器选定的 DOM 节点数组。Ext.DomQuery.select方法的缩写。
参数：
  • path : String
    选择器/xpath 查询路径
  • root : Node
    （可选） 查询的根（默认为“document”）。
返回：
  • Array
这个方法由 Ext 对象定义。

select

public function select(String/Array selector, [Boolean unique])
选择一个由 CSS 选择器选定的元素。
参数：
  • selector : String/Array
    CSS 选择器或元素数组
  • unique : Boolean
    （可选） 为“true”时将为每个元素创建一个唯一的 Ext.Element 对象（默认为一个共享享元对象）
返回：
  • CompositeElementLite/CompositeElement
这个方法由 Ext 对象定义。

urlDecode

public function urlDecode(String string, [Boolean overwrite])
将指定的 URL 地址解码并将其转换为一个对象。例如：“Ext.urlDecode("foo=1&bar=2");”将返回“{foo: 1, bar: 2}”，又如：“Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", true);”将返回“{foo: 1, bar: [2, 3, 4]}”。
参数：
  • string : String
  • overwrite : Boolean
    （可选） 拥有相同名字的项目将会覆盖前一个值，而不是创建一个数组（默认为“false”）。
返回：
  • Object
    直接量成员
这个方法由 Ext 对象定义。

urlEncode

public function urlEncode(Object o)
将指定的对象转换为经过编码的 URL。例如：“Ext.urlEncode({foo: 1, bar: 2});”将返回“foo=1&bar=2”。可选，属性值可以是数组，代替值和返回的合成字串将会为成对包含的“名/值”。
参数：
  • o : Object
返回：
  • String
这个方法由 Ext 对象定义。
Ext - Copyright © 2006-2007 Ext JS, LLC
All rights reserved.