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 pub.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 * Applies a style specification to an element.
\r
98 * @param {String/HTMLElement} el The element to apply styles to
\r
99 * @param {String/Object/Function} styles A style specification string e.g. 'width:100px', or object in the form {width:'100px'}, or
\r
100 * a function which returns such a specification.
\r
102 applyStyles : function(el, styles){
\r
109 if(Ext.isFunction(styles)){
\r
110 styles = styles.call();
\r
112 if(Ext.isString(styles)){
\r
113 styles = styles.trim().split(/\s*(?::|;)\s*/);
\r
114 for(len = styles.length; i < len;){
\r
115 el.setStyle(styles[i++], styles[i++]);
\r
117 }else if (Ext.isObject(styles)){
\r
118 el.setStyle(styles);
\r
124 * Creates new DOM element(s) and inserts them before el.
\r
125 * @param {Mixed} el The context element
\r
126 * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
\r
127 * @param {Boolean} returnElement (optional) true to return a Ext.Element
\r
128 * @return {HTMLElement/Ext.Element} The new node
\r
131 insertBefore : function(el, o, returnElement){
\r
132 return doInsert(el, o, returnElement, beforebegin);
\r
136 * Creates new DOM element(s) and inserts them after el.
\r
137 * @param {Mixed} el The context element
\r
138 * @param {Object} o The DOM object spec (and children)
\r
139 * @param {Boolean} returnElement (optional) true to return a Ext.Element
\r
140 * @return {HTMLElement/Ext.Element} The new node
\r
143 insertAfter : function(el, o, returnElement){
\r
144 return doInsert(el, o, returnElement, afterend, 'nextSibling');
\r
148 * Creates new DOM element(s) and inserts them as the first child of el.
\r
149 * @param {Mixed} el The context element
\r
150 * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
\r
151 * @param {Boolean} returnElement (optional) true to return a Ext.Element
\r
152 * @return {HTMLElement/Ext.Element} The new node
\r
155 insertFirst : function(el, o, returnElement){
\r
156 return doInsert(el, o, returnElement, afterbegin, 'firstChild');
\r
160 * Creates new DOM element(s) and appends them to el.
\r
161 * @param {Mixed} el The context element
\r
162 * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
\r
163 * @param {Boolean} returnElement (optional) true to return a Ext.Element
\r
164 * @return {HTMLElement/Ext.Element} The new node
\r
167 append: function(el, o, returnElement){
\r
168 return doInsert(el, o, returnElement, beforeend, '', true);
\r
172 * Creates new DOM element(s) without inserting them to the document.
\r
173 * @param {Object/String} o The DOM object spec (and children) or raw HTML blob
\r
174 * @return {HTMLElement} The new uninserted node
\r
176 createDom: createDom
\r