3 * Copyright(c) 2006-2009 Ext JS, LLC
5 * http://www.extjs.com/license
8 * @class Ext.DomHelper
\r
10 Ext.apply(Ext.DomHelper,
\r
13 afterbegin = 'afterbegin',
\r
14 afterend = 'afterend',
\r
15 beforebegin = 'beforebegin',
\r
16 beforeend = 'beforeend';
\r
19 function doInsert(el, o, returnElement, pos, sibling, append){
\r
20 el = Ext.getDom(el);
\r
23 newNode = createDom(o, null);
\r
25 el.appendChild(newNode);
\r
27 (sibling == 'firstChild' ? el : el.parentNode).insertBefore(newNode, el[sibling] || el);
\r
30 newNode = Ext.DomHelper.insertHtml(pos, el, Ext.DomHelper.createHtml(o));
\r
32 return returnElement ? Ext.get(newNode, true) : newNode;
\r
37 function createDom(o, parentNode){
\r
45 if (Ext.isArray(o)) { // Allow Arrays of siblings to be inserted
\r
46 el = doc.createDocumentFragment(); // in one shot using a DocumentFragment
\r
47 Ext.each(o, function(v) {
\r
50 } else if (Ext.isString(o)) { // Allow a string as a child spec.
\r
51 el = doc.createTextNode(o);
\r
53 el = doc.createElement( o.tag || 'div' );
\r
54 useSet = !!el.setAttribute; // In IE some elements don't have setAttribute
\r
55 Ext.iterate(o, function(attr, val){
\r
56 if(!/tag|children|cn|html|style/.test(attr)){
\r
61 el.setAttribute(attr, val);
\r
68 Ext.DomHelper.applyStyles(el, o.style);
\r
70 if ((cn = o.children || o.cn)) {
\r
72 } else if (o.html) {
\r
73 el.innerHTML = o.html;
\r
77 parentNode.appendChild(el);
\r
84 * Creates a new Ext.Template from the DOM object spec.
\r
85 * @param {Object} o The DOM object spec (and children)
\r
86 * @return {Ext.Template} The new template
\r
88 createTemplate : function(o){
\r
89 var html = Ext.DomHelper.createHtml(o);
\r
90 return new Ext.Template(html);
\r
93 /** True to force the use of DOM instead of html fragments @type Boolean */
\r
97 * Creates new DOM element(s) and inserts them before el.
\r
98 * @param {Mixed} el The context element
\r
99 * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
\r
100 * @param {Boolean} returnElement (optional) true to return a Ext.Element
\r
101 * @return {HTMLElement/Ext.Element} The new node
\r
104 insertBefore : function(el, o, returnElement){
\r
105 return doInsert(el, o, returnElement, beforebegin);
\r
109 * Creates new DOM element(s) and inserts them after el.
\r
110 * @param {Mixed} el The context element
\r
111 * @param {Object} o The DOM object spec (and children)
\r
112 * @param {Boolean} returnElement (optional) true to return a Ext.Element
\r
113 * @return {HTMLElement/Ext.Element} The new node
\r
116 insertAfter : function(el, o, returnElement){
\r
117 return doInsert(el, o, returnElement, afterend, 'nextSibling');
\r
121 * Creates new DOM element(s) and inserts them as the first child of el.
\r
122 * @param {Mixed} el The context element
\r
123 * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
\r
124 * @param {Boolean} returnElement (optional) true to return a Ext.Element
\r
125 * @return {HTMLElement/Ext.Element} The new node
\r
128 insertFirst : function(el, o, returnElement){
\r
129 return doInsert(el, o, returnElement, afterbegin, 'firstChild');
\r
133 * Creates new DOM element(s) and appends them to el.
\r
134 * @param {Mixed} el The context element
\r
135 * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
\r
136 * @param {Boolean} returnElement (optional) true to return a Ext.Element
\r
137 * @return {HTMLElement/Ext.Element} The new node
\r
140 append: function(el, o, returnElement){
\r
141 return doInsert(el, o, returnElement, beforeend, '', true);
\r
145 * Creates new DOM element(s) without inserting them to the document.
\r
146 * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
\r
147 * @return {HTMLElement} The new uninserted node
\r
149 createDom: createDom
\r