ExtJs4常用工具类与函数之Ext.core.DomHelper

Ext作为一个AJAX框架，与HTML、DOM交互、操作非常多，DomHelper类在当中起到了很好的耦合作用，让胡勇通过Ext来透明的操作HTML或DOM。这样就可以很方便的操作Ext的Element和HTMLElement了。

1.Ext.core.DomHelper.append()

通过el获取该节点将o追加到el的子节点,如果returnElement为true则返回追加后形成的Ext的Element,否则返回追加后形成的HTMLElement.

调用格式:

Ext.core.DomHelper.append(Mixed el,Object/String o,[Boolean returnElement])

参数说明:

el:指定的HTML的Element或DOMElement.

o:追加到el节点后的对象挥着指定的字符串值.

returnElement:标识返回追加后形成的节点是HTMLElement还是DomElement,如果为true,则返回Ext.core.Element 即DOM Element.

返回值:

返回Ext.Element或HTML Element.

2.Ext.core.DomHelper.applyStyle()

给指定的HTML Element(元素节点) 应用指定的CSS(样式表)效果.

调用格式:

Ext.core.DomHelper.applyStyle(String/HTML Element el,String/Object/Function styles)

参数说明:

el:HTML Element对象的id或HTML Element对.

styles: 应用的CSS样式表

返回值:无.

3.createTemplate()

通过指定的对象或字符串,创建一个Ext.Template(Ext的标准模版),最后返回该模版.

调用格式:

Ext.core.DomHelper.createTemplate(Object o)

参数:

o:通过该对象来创建一个Dom对象.

返回值:返回创建的Ext.Template对象.

4.insertAfter()

获取指定的Element,将新节点追加在获取的Element之后,最后返回指定的节点.

调用格式:

Ext.core.DomHelper.insertAfter(Mixed el, Object o,[Boolean returnElement])

参数说明:

el:指定的上下文Element.

o:欲追加的对象或Dom节点

[returnElement]:可选参数,表示是否返回插入节点后形成的新的Ext.Element,否则返回的是插入节点后形成的HTML Element.

返回值:HTMLElement 或ext.Element

5.insertBefore()

获取指定的Element,将新节点追加在获取的Element之前,最后返回指定的节点.

调用格式:

Ext.core.DomHelper.insertBefore(Mixed el, Object o,[Boolean returnElement])

参数说明:

el:指定的上下文Element.

o:欲追加的对象或Dom节点

[returnElement]:可选参数,表示是否返回插入节点后形成的新的Ext.Element,否则返回的是插入节点后形成的HTML Element.

返回值:HTMLElement 或ext.Element

6.insertFirst()

创建由o形成的对象追加在指定的Element下,成为Element的第一个子元素,最后插入并追加后的节点.

调用格式:

Ext.core.DomHelper.insertFirst(Mixed el, Object/String o,[Boolean returnElement])

参数说明:

el:指定的上下文Element.

o:新插入的对象或由字符串描述的节点.

[returnElement]:可选参数,表示是否返回插入节点后形成的新的Ext.Element,否则返回的是插入节点后形成的HTML Element.

返回值:HTMLElement 或Ext.Element

7.insertHtml()

在给定的HTMLElement中指定的位置插入HTML,并返回追加插入的HTMLElement.

调用格式:

Ext.core.DomHelper.insertHtml(String where, HTML Element el ,String html)

参数说明:

where:插入html 的位置,该值只能是beforeBegin/afterBegin/beforeEnd/afterEnd.

el:指定的HTMl Element,目标HTML元素.

html:要插入的HTML字符串.

返回值:HTMLElement

8.overwrite()

获取该指定的Element,按新的内容体覆盖Element的内部主体,并返回覆盖后的节点.

调用格式:

Ext.core.DomHelper.overwrite(Mixed el, Object/String o ,[Boolean returnElement])

参数说明:

el:指定的元素节点.

o:新插入的对象或由字符串描述的节点.

[returnElement]:可选参数,表示是否返回插入节点后形成的新的Ext.Element,否则返回的是插入节点后形成的HTML Element.

返回值:HTMLElement 或Ext.Element