| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492 | <!DOCTYPE html><html><head>  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />  <title>The source code</title>  <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />  <script type="text/javascript" src="../resources/prettify/prettify.js"></script>  <style type="text/css">    .highlight { display: block; background-color: #ddd; }  </style>  <script type="text/javascript">    function highlight() {      document.getElementById(location.hash.replace(/#/, "")).className = "highlight";    }  </script></head><body onload="prettyPrint(); highlight();">  <pre class="prettyprint lang-js"><span id='Ext-DomHelper'>/**</span> * @class Ext.DomHelper * @extends Ext.dom.Helper * @alternateClassName Ext.core.DomHelper * @singleton * * The DomHelper class provides a layer of abstraction from DOM and transparently supports creating elements via DOM or * using HTML fragments. It also has the ability to create HTML fragment templates from your DOM building code. * * # DomHelper element specification object * * A specification object is used when creating elements. Attributes of this object are assumed to be element * attributes, except for 4 special attributes: * * - **tag** - The tag name of the element. * - **children** or **cn** - An array of the same kind of element definition objects to be created and appended. *   These can be nested as deep as you want. * - **cls** - The class attribute of the element. This will end up being either the "class" attribute on a HTML *   fragment or className for a DOM node, depending on whether DomHelper is using fragments or DOM. * - **html** - The innerHTML for the element. * * **NOTE:** For other arbitrary attributes, the value will currently **not** be automatically HTML-escaped prior to * building the element's HTML string. This means that if your attribute value contains special characters that would * not normally be allowed in a double-quoted attribute value, you **must** manually HTML-encode it beforehand (see * {@link Ext.String#htmlEncode}) or risk malformed HTML being created. This behavior may change in a future release. * * # Insertion methods * * Commonly used insertion methods: * * - **{@link #append}** * - **{@link #insertBefore}** * - **{@link #insertAfter}** * - **{@link #overwrite}** * - **{@link #createTemplate}** * - **{@link #insertHtml}** * * # Example * * This is an example, where an unordered list with 3 children items is appended to an existing element with * id 'my-div': * *     var dh = Ext.DomHelper; // create shorthand alias *     // specification object *     var spec = { *         id: 'my-ul', *         tag: 'ul', *         cls: 'my-list', *         // append children after creating *         children: [     // may also specify 'cn' instead of 'children' *             {tag: 'li', id: 'item0', html: 'List Item 0'}, *             {tag: 'li', id: 'item1', html: 'List Item 1'}, *             {tag: 'li', id: 'item2', html: 'List Item 2'} *         ] *     }; *     var list = dh.append( *         'my-div', // the context element 'my-div' can either be the id or the actual node *         spec      // the specification object *     ); * * Element creation specification parameters in this class may also be passed as an Array of specification objects. This * can be used to insert multiple sibling nodes into an existing container very efficiently. For example, to add more * list items to the example above: * *     dh.append('my-ul', [ *         {tag: 'li', id: 'item3', html: 'List Item 3'}, *         {tag: 'li', id: 'item4', html: 'List Item 4'} *     ]); * * # Templating * * The real power is in the built-in templating. Instead of creating or appending any elements, {@link #createTemplate} * returns a Template object which can be used over and over to insert new elements. Revisiting the example above, we * could utilize templating this time: * *     // create the node *     var list = dh.append('my-div', {tag: 'ul', cls: 'my-list'}); *     // get template *     var tpl = dh.createTemplate({tag: 'li', id: 'item{0}', html: 'List Item {0}'}); * *     for(var i = 0; i < 5, i++){ *         tpl.append(list, [i]); // use template to append to the actual node *     } * * An example using a template: * *     var html = '<a id="{0}" href="{1}" class="nav">{2}</a>'; * *     var tpl = new Ext.DomHelper.createTemplate(html); *     tpl.append('blog-roll', ['link1', 'http://www.edspencer.net/', "Ed's Site"]); *     tpl.append('blog-roll', ['link2', 'http://www.dustindiaz.com/', "Dustin's Site"]); * * The same example using named parameters: * *     var html = '<a id="{id}" href="{url}" class="nav">{text}</a>'; * *     var tpl = new Ext.DomHelper.createTemplate(html); *     tpl.append('blog-roll', { *         id: 'link1', *         url: 'http://www.edspencer.net/', *         text: "Ed's Site" *     }); *     tpl.append('blog-roll', { *         id: 'link2', *         url: 'http://www.dustindiaz.com/', *         text: "Dustin's Site" *     }); * * # Compiling Templates * * Templates are applied using regular expressions. The performance is great, but if you are adding a bunch of DOM * elements using the same template, you can increase performance even further by {@link Ext.Template#compile * "compiling"} the template. The way "{@link Ext.Template#compile compile()}" works is the template is parsed and * broken up at the different variable points and a dynamic function is created and eval'ed. The generated function * performs string concatenation of these parts and the passed variables instead of using regular expressions. * *     var html = '<a id="{id}" href="{url}" class="nav">{text}</a>'; * *     var tpl = new Ext.DomHelper.createTemplate(html); *     tpl.compile(); * *     //... use template like normal * * # Performance Boost * * DomHelper will transparently create HTML fragments when it can. Using HTML fragments instead of DOM can significantly * boost performance. * * Element creation specification parameters may also be strings. If {@link #useDom} is false, then the string is used * as innerHTML. If {@link #useDom} is true, a string specification results in the creation of a text node. Usage: * *     Ext.DomHelper.useDom = true; // force it to use DOM; reduces performance * */(function() {// kill repeat to save bytesvar afterbegin = 'afterbegin',    afterend = 'afterend',    beforebegin = 'beforebegin',    beforeend = 'beforeend',    ts = '<table>',    te = '</table>',    tbs = ts+'<tbody>',    tbe = '</tbody>'+te,    trs = tbs + '<tr>',    tre = '</tr>'+tbe,    detachedDiv = document.createElement('div'),    bbValues = ['BeforeBegin', 'previousSibling'],    aeValues = ['AfterEnd', 'nextSibling'],    bb_ae_PositionHash = {        beforebegin: bbValues,        afterend: aeValues    },    fullPositionHash = {        beforebegin: bbValues,        afterend: aeValues,        afterbegin: ['AfterBegin', 'firstChild'],        beforeend: ['BeforeEnd', 'lastChild']    };<span id='Ext-dom-Helper'>/**</span> * The actual class of which {@link Ext.DomHelper} is instance of. *  * Use singleton {@link Ext.DomHelper} instead. *  * @private */Ext.define('Ext.dom.Helper', {    extend: 'Ext.dom.AbstractHelper',    tableRe: /^table|tbody|tr|td$/i,    tableElRe: /td|tr|tbody/i,<span id='Ext-dom-Helper-property-useDom'>    /**</span>     * @property {Boolean} useDom     * True to force the use of DOM instead of html fragments.     */    useDom : false,<span id='Ext-dom-Helper-method-createDom'>    /**</span>     * Creates new DOM element(s) without inserting them to the document.     * @param {Object/String} o The DOM object spec (and children) or raw HTML blob     * @return {HTMLElement} The new uninserted node     */    createDom: function(o, parentNode){        var el,            doc = document,            useSet,            attr,            val,            cn,            i, l;        if (Ext.isArray(o)) {                       // Allow Arrays of siblings to be inserted            el = doc.createDocumentFragment(); // in one shot using a DocumentFragment            for (i = 0, l = o.length; i < l; i++) {                this.createDom(o[i], el);            }        } else if (typeof o == 'string') {         // Allow a string as a child spec.            el = doc.createTextNode(o);        } else {            el = doc.createElement(o.tag || 'div');            useSet = !!el.setAttribute; // In IE some elements don't have setAttribute            for (attr in o) {                if (!this.confRe.test(attr)) {                    val = o[attr];                    if (attr == 'cls') {                        el.className = val;                    } else {                        if (useSet) {                            el.setAttribute(attr, val);                        } else {                            el[attr] = val;                        }                    }                }            }            Ext.DomHelper.applyStyles(el, o.style);            if ((cn = o.children || o.cn)) {                this.createDom(cn, el);            } else if (o.html) {                el.innerHTML = o.html;            }        }        if (parentNode) {            parentNode.appendChild(el);        }        return el;    },    ieTable: function(depth, openingTags, htmlContent, closingTags){        detachedDiv.innerHTML = [openingTags, htmlContent, closingTags].join('');        var i = -1,            el = detachedDiv,            ns;        while (++i < depth) {            el = el.firstChild;        }        // If the result is multiple siblings, then encapsulate them into one fragment.        ns = el.nextSibling;        if (ns) {            el = document.createDocumentFragment();            while (ns) {                el.appendChild(ns);                ns = ns.nextSibling;            }        }        return el;    },<span id='Ext-dom-Helper-method-insertIntoTable'>    /**</span>     * @private     * Nasty code for IE's broken table implementation     */    insertIntoTable: function(tag, where, destinationEl, html) {        var node,            before,            bb = where == beforebegin,            ab = where == afterbegin,            be = where == beforeend,            ae = where == afterend;        if (tag == 'td' && (ab || be) || !this.tableElRe.test(tag) && (bb || ae)) {            return null;        }        before = bb ? destinationEl :                 ae ? destinationEl.nextSibling :                 ab ? destinationEl.firstChild : null;        if (bb || ae) {            destinationEl = destinationEl.parentNode;        }        if (tag == 'td' || (tag == 'tr' && (be || ab))) {            node = this.ieTable(4, trs, html, tre);        } else if ((tag == 'tbody' && (be || ab)) ||                (tag == 'tr' && (bb || ae))) {            node = this.ieTable(3, tbs, html, tbe);        } else {            node = this.ieTable(2, ts, html, te);        }        destinationEl.insertBefore(node, before);        return node;    },<span id='Ext-dom-Helper-method-createContextualFragment'>    /**</span>     * @private     * Fix for IE9 createContextualFragment missing method     */    createContextualFragment: function(html) {        var fragment = document.createDocumentFragment(),            length, childNodes;        detachedDiv.innerHTML = html;        childNodes = detachedDiv.childNodes;        length = childNodes.length;        // Move nodes into fragment, don't clone: http://jsperf.com/create-fragment        while (length--) {            fragment.appendChild(childNodes[0]);        }        return fragment;    },    applyStyles: function(el, styles) {        if (styles) {            el = Ext.fly(el);            if (typeof styles == "function") {                styles = styles.call();            }            if (typeof styles == "string") {                styles = Ext.dom.Element.parseStyles(styles);            }            if (typeof styles == "object") {                el.setStyle(styles);            }        }    },<span id='Ext-dom-Helper-method-createHtml'>    /**</span>     * Alias for {@link #markup}.     * @inheritdoc Ext.dom.AbstractHelper#markup     */    createHtml: function(spec) {        return this.markup(spec);    },    doInsert: function(el, o, returnElement, pos, sibling, append) {                el = el.dom || Ext.getDom(el);        var newNode;        if (this.useDom) {            newNode = this.createDom(o, null);            if (append) {                el.appendChild(newNode);            }            else {                (sibling == 'firstChild' ? el : el.parentNode).insertBefore(newNode, el[sibling] || el);            }        } else {            newNode = this.insertHtml(pos, el, this.markup(o));        }        return returnElement ? Ext.get(newNode, true) : newNode;    },<span id='Ext-dom-Helper-method-overwrite'>    /**</span>     * Creates new DOM element(s) and overwrites the contents of el with them.     * @param {String/HTMLElement/Ext.Element} el The context element     * @param {Object/String} o The DOM object spec (and children) or raw HTML blob     * @param {Boolean} [returnElement] true to return an Ext.Element     * @return {HTMLElement/Ext.Element} The new node     */    overwrite: function(el, html, returnElement) {        var newNode;        el = Ext.getDom(el);        html = this.markup(html);        // IE Inserting HTML into a table/tbody/tr requires extra processing: http://www.ericvasilik.com/2006/07/code-karma.html        if (Ext.isIE && this.tableRe.test(el.tagName)) {            // Clearing table elements requires removal of all elements.            while (el.firstChild) {                el.removeChild(el.firstChild);            }            if (html) {                newNode = this.insertHtml('afterbegin', el, html);                return returnElement ? Ext.get(newNode) : newNode;            }            return null;        }        el.innerHTML = html;        return returnElement ? Ext.get(el.firstChild) : el.firstChild;    },    insertHtml: function(where, el, html) {        var hashVal,            range,            rangeEl,            setStart,            frag;        where = where.toLowerCase();        // Has fast HTML insertion into existing DOM: http://www.w3.org/TR/html5/apis-in-html-documents.html#insertadjacenthtml        if (el.insertAdjacentHTML) {            // IE's incomplete table implementation: http://www.ericvasilik.com/2006/07/code-karma.html            if (Ext.isIE && this.tableRe.test(el.tagName) && (frag = this.insertIntoTable(el.tagName.toLowerCase(), where, el, html))) {                return frag;            }            if ((hashVal = fullPositionHash[where])) {                el.insertAdjacentHTML(hashVal[0], html);                return el[hashVal[1]];            }            // if (not IE and context element is an HTMLElement) or TextNode        } else {            // we cannot insert anything inside a textnode so...            if (el.nodeType === 3) {                where = where === 'afterbegin' ? 'beforebegin' : where;                where = where === 'beforeend' ? 'afterend' : where;            }            range = Ext.supports.CreateContextualFragment ? el.ownerDocument.createRange() : undefined;            setStart = 'setStart' + (this.endRe.test(where) ? 'After' : 'Before');            if (bb_ae_PositionHash[where]) {                if (range) {                    range[setStart](el);                    frag = range.createContextualFragment(html);                } else {                    frag = this.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) {                    if (range) {                        range[setStart](el[rangeEl]);                        frag = range.createContextualFragment(html);                    } else {                        frag = this.createContextualFragment(html);                    }                    if (where == afterbegin) {                        el.insertBefore(frag, el.firstChild);                    } else {                        el.appendChild(frag);                    }                } else {                    el.innerHTML = html;                }                return el[rangeEl];            }        }        //<debug>        Ext.Error.raise({            sourceClass: 'Ext.DomHelper',            sourceMethod: 'insertHtml',            htmlToInsert: html,            targetElement: el,            msg: 'Illegal insertion point reached: "' + where + '"'        });        //</debug>    },<span id='Ext-dom-Helper-method-createTemplate'>    /**</span>     * Creates a new Ext.Template from the DOM object spec.     * @param {Object} o The DOM object spec (and children)     * @return {Ext.Template} The new template     */    createTemplate: function(o) {        var html = this.markup(o);        return new Ext.Template(html);    }}, function() {    Ext.ns('Ext.core');    Ext.DomHelper = Ext.core.DomHelper = new this;});}());</pre></body></html>
 |