读Ext之十二(在各个位置插入元素)
IE 除了发明 innerHTML这个快捷创建DOM元素(及其属性等)外,还发明了insertAdjacentHTML/insertAdjacentText 方法。
它们首次在IE4中引入,随后其它浏览器如Opera、Safari、Chrome相继实现了它们。唯独Firefox没有实现。
(注:2011-11 Firefox8发布,已支持insertAdjacentHTML,但仍未支持insertAdjacentText)
鉴于insertAdjacentHTML被众多浏览器实现,html5已经将 其 列纳入,insertAdjacentText则没那么幸运。
Firefox中使用另外一些方式实现了相同功能。在 这篇 中通过扩展HTMLElement.prototype为Firefox实现了与IE相同的接口方法。
在Ext.DomHelper中,它没有去扩展HTMLElement.prototype(部分人会认为是污染了原生的HTMLElement,暂且放一边)。而是提供了以下四个方法
insertBefore 在元素前面插入新的元素
insertAfter 在元素后面插入新的元素
insertFirst 在元素内部的第一个位置插入新的元素
append 在元素内部最后一个位置插入新的元素
在上一篇中提到了,这四个方法都调用私有的doInsert函数,而doInsert函数内部调用的是Ext.DomHelper的insertHtml方法。
可回到 上一篇 看看那个截图 便一目了然。因此insertHtml方法是实现各种方式插入元素的核心方法,以上是提供给客户端程序员的四个接口方法。
insertHtml : function(where, el, html){ var hash = {}, hashVal, setStart, range, frag, rangeEl, rs; where = where.toLowerCase(); // add these here because they are used in both branches of the condition. hash[beforebegin] = ['BeforeBegin', 'previousSibling']; hash[afterend] = ['AfterEnd', 'nextSibling']; if (el.insertAdjacentHTML) { if(tableRe.test(el.tagName) && (rs = insertIntoTable(el.tagName.toLowerCase(), where, el, html))){ return rs; } // add these two to the hash. hash[afterbegin] = ['AfterBegin', 'firstChild']; hash[beforeend] = ['BeforeEnd', 'lastChild']; if ((hashVal = hash[where])) { el.insertAdjacentHTML(hashVal[0], html); return el[hashVal[1]]; } } else { range = el.ownerDocument.createRange(); setStart = 'setStart' + (/end/i.test(where) ? 'After' : 'Before'); if (hash[where]) { range[setStart](el); frag = range.createContextualFragment(html); el.parentNode.insertBefore(frag, where == beforebegin ? el : el.nextSibling); return el[(where == beforebegin ? 'previous' : 'next') + 'Sibling']; } else { rangeEl = (where == afterbegin ? 'first' : 'last') + 'Child'; if (el.firstChild) { range[setStart](el[rangeEl]); frag = range.createContextualFragment(html); if(where == afterbegin){ el.insertBefore(frag, el.firstChild); }else{ el.appendChild(frag); } } else { el.innerHTML = html; } return el[rangeEl]; } } throw 'Illegal insertion point -> "' + where + '"'; },
insertHtml 的实现也较容易理解,两个分支
分支1,支持el.insertAdjacentHTML的浏览器(IE/Chrome/Safari/Opera)使用el.insertAdjacentHTML
分支2,不支持el.insertAdjacentHTML的浏览器(Firefox)使用range.createContextualFragment+el.insertBefore/el.appendChild
分支1中对table/tr/td元素做了单独处理,相应的私有函数是ieTable,insertIntoTable。insertIntoTable中先创建了一个div再添加table,是因为 IE6/7/8中Table元素的innerHTML Bug 。
Ext.DomHelper 还剩下最后一个方法applyStyles,
applyStyles : function(el, styles){ if(styles){ var i = 0, len, style; el = Ext.fly(el); if(Ext.isFunction(styles)){ styles = styles.call(); } if(Ext.isString(styles)){ styles = styles.trim().split(/\s*(?::|;)\s*/); for(len = styles.length; i < len;){ el.setStyle(styles[i++], styles[i++]); } }else if (Ext.isObject(styles)){ el.setStyle(styles); } } },
设置HTML元素的的样式,设置的方式很灵活,参数styles可以是字符串'color:red',可以是对象{color:red}甚至可以是个函数function(){return 'color:red'}。
el = Ext.fly(el);
该句中的Ext.fly是获取Ext.Element对象,定义在Ext.Element中。后一篇提到了Ext.fly与Ext.get的区别。。
styles = styles.call();
当styles为函数类型时,直接调用该函数,此处用call执行函数,但没有传参数。因此完全可以去掉call直接使用小括号()调用:styles = styles();
函数的各种调用方式见:具名函数的四种调用方式
当styles为字符串类型时,有以下语句
styles = styles.trim().split(/\s*(?::|;)\s*/);
直接使用 trim 方法,但Ext并没有为String扩展该方法,还记得第三篇 原型扩展 ,只给String添加了一个format方法。
Ext.applyIf(String, { format : function(format){ var args = Ext.toArray(arguments, 1); return format.replace(/\{(\d+)\}/g, function(m, i){ return args[i]; }); } });