Upgrade to ExtJS 3.0.0 - Released 07/06/2009
[extjs.git] / docs / source / DomQuery.html
diff --git a/docs/source/DomQuery.html b/docs/source/DomQuery.html
new file mode 100644 (file)
index 0000000..712f228
--- /dev/null
@@ -0,0 +1,830 @@
+<html>\r
+<head>\r
+  <title>The source code</title>\r
+    <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />\r
+    <script type="text/javascript" src="../resources/prettify/prettify.js"></script>\r
+</head>\r
+<body  onload="prettyPrint();">\r
+    <pre class="prettyprint lang-js">/*\r
+ * This is code is also distributed under MIT license for use\r
+ * with jQuery and prototype JavaScript libraries.\r
+ */\r
+<div id="cls-Ext.DomQuery"></div>/**\r
+ * @class Ext.DomQuery\r
+Provides high performance selector/xpath processing by compiling queries into reusable functions. New pseudo classes and matchers can be plugged. It works on HTML and XML documents (if a content node is passed in).\r
+<p>\r
+DomQuery supports most of the <a href="http://www.w3.org/TR/2005/WD-css3-selectors-20051215/#selectors">CSS3 selectors spec</a>, along with some custom selectors and basic XPath.</p>\r
+\r
+<p>\r
+All selectors, attribute filters and pseudos below can be combined infinitely in any order. For example "div.foo:nth-child(odd)[@foo=bar].bar:first" would be a perfectly valid selector. Node filters are processed in the order in which they appear, which allows you to optimize your queries for your document structure.\r
+</p>\r
+<h4>Element Selectors:</h4>\r
+<ul class="list">\r
+    <li> <b>*</b> any element</li>\r
+    <li> <b>E</b> an element with the tag E</li>\r
+    <li> <b>E F</b> All descendent elements of E that have the tag F</li>\r
+    <li> <b>E > F</b> or <b>E/F</b> all direct children elements of E that have the tag F</li>\r
+    <li> <b>E + F</b> all elements with the tag F that are immediately preceded by an element with the tag E</li>\r
+    <li> <b>E ~ F</b> all elements with the tag F that are preceded by a sibling element with the tag E</li>\r
+</ul>\r
+<h4>Attribute Selectors:</h4>\r
+<p>The use of &#64; and quotes are optional. For example, div[&#64;foo='bar'] is also a valid attribute selector.</p>\r
+<ul class="list">\r
+    <li> <b>E[foo]</b> has an attribute "foo"</li>\r
+    <li> <b>E[foo=bar]</b> has an attribute "foo" that equals "bar"</li>\r
+    <li> <b>E[foo^=bar]</b> has an attribute "foo" that starts with "bar"</li>\r
+    <li> <b>E[foo$=bar]</b> has an attribute "foo" that ends with "bar"</li>\r
+    <li> <b>E[foo*=bar]</b> has an attribute "foo" that contains the substring "bar"</li>\r
+    <li> <b>E[foo%=2]</b> has an attribute "foo" that is evenly divisible by 2</li>\r
+    <li> <b>E[foo!=bar]</b> has an attribute "foo" that does not equal "bar"</li>\r
+</ul>\r
+<h4>Pseudo Classes:</h4>\r
+<ul class="list">\r
+    <li> <b>E:first-child</b> E is the first child of its parent</li>\r
+    <li> <b>E:last-child</b> E is the last child of its parent</li>\r
+    <li> <b>E:nth-child(<i>n</i>)</b> E is the <i>n</i>th child of its parent (1 based as per the spec)</li>\r
+    <li> <b>E:nth-child(odd)</b> E is an odd child of its parent</li>\r
+    <li> <b>E:nth-child(even)</b> E is an even child of its parent</li>\r
+    <li> <b>E:only-child</b> E is the only child of its parent</li>\r
+    <li> <b>E:checked</b> E is an element that is has a checked attribute that is true (e.g. a radio or checkbox) </li>\r
+    <li> <b>E:first</b> the first E in the resultset</li>\r
+    <li> <b>E:last</b> the last E in the resultset</li>\r
+    <li> <b>E:nth(<i>n</i>)</b> the <i>n</i>th E in the resultset (1 based)</li>\r
+    <li> <b>E:odd</b> shortcut for :nth-child(odd)</li>\r
+    <li> <b>E:even</b> shortcut for :nth-child(even)</li>\r
+    <li> <b>E:contains(foo)</b> E's innerHTML contains the substring "foo"</li>\r
+    <li> <b>E:nodeValue(foo)</b> E contains a textNode with a nodeValue that equals "foo"</li>\r
+    <li> <b>E:not(S)</b> an E element that does not match simple selector S</li>\r
+    <li> <b>E:has(S)</b> an E element that has a descendent that matches simple selector S</li>\r
+    <li> <b>E:next(S)</b> an E element whose next sibling matches simple selector S</li>\r
+    <li> <b>E:prev(S)</b> an E element whose previous sibling matches simple selector S</li>\r
+</ul>\r
+<h4>CSS Value Selectors:</h4>\r
+<ul class="list">\r
+    <li> <b>E{display=none}</b> css value "display" that equals "none"</li>\r
+    <li> <b>E{display^=none}</b> css value "display" that starts with "none"</li>\r
+    <li> <b>E{display$=none}</b> css value "display" that ends with "none"</li>\r
+    <li> <b>E{display*=none}</b> css value "display" that contains the substring "none"</li>\r
+    <li> <b>E{display%=2}</b> css value "display" that is evenly divisible by 2</li>\r
+    <li> <b>E{display!=none}</b> css value "display" that does not equal "none"</li>\r
+</ul>\r
+ * @singleton\r
+ */\r
+Ext.DomQuery = function(){\r
+    var cache = {}, \r
+       simpleCache = {}, \r
+       valueCache = {},\r
+       nonSpace = /\S/,\r
+       trimRe = /^\s+|\s+$/g,\r
+       tplRe = /\{(\d+)\}/g,\r
+       modeRe = /^(\s?[\/>+~]\s?|\s|$)/,\r
+       tagTokenRe = /^(#)?([\w-\*]+)/,\r
+       nthRe = /(\d*)n\+?(\d*)/, \r
+       nthRe2 = /\D/,\r
+       // This is for IE MSXML which does not support expandos.\r
+           // IE runs the same speed using setAttribute, however FF slows way down\r
+           // and Safari completely fails so they need to continue to use expandos.\r
+           isIE = window.ActiveXObject ? true : false,\r
+        isOpera = Ext.isOpera,\r
+           key = 30803;\r
+           \r
+    // this eval is stop the compressor from\r
+       // renaming the variable to something shorter\r
+       eval("var batch = 30803;");     \r
+\r
+    function child(p, index){\r
+        var i = 0,\r
+               n = p.firstChild;\r
+        while(n){\r
+            if(n.nodeType == 1){\r
+               if(++i == index){\r
+                   return n;\r
+               }\r
+            }\r
+            n = n.nextSibling;\r
+        }\r
+        return null;\r
+    };\r
+\r
+    function next(n){\r
+        while((n = n.nextSibling) && n.nodeType != 1);\r
+        return n;\r
+    };\r
+\r
+    function prev(n){\r
+        while((n = n.previousSibling) && n.nodeType != 1);\r
+        return n;\r
+    };\r
+\r
+    function children(d){\r
+        var n = d.firstChild, ni = -1,\r
+               nx;\r
+           while(n){\r
+               nx = n.nextSibling;\r
+               if(n.nodeType == 3 && !nonSpace.test(n.nodeValue)){\r
+                   d.removeChild(n);\r
+               }else{\r
+                   n.nodeIndex = ++ni;\r
+               }\r
+               n = nx;\r
+           }\r
+           return this;\r
+       };\r
+\r
+    function byClassName(c, a, v){\r
+        if(!v){\r
+            return c;\r
+        }\r
+        var r = [], ri = -1, cn;\r
+        for(var i = 0, ci; ci = c[i]; i++){\r
+            if((' '+ci.className+' ').indexOf(v) != -1){\r
+                r[++ri] = ci;\r
+            }\r
+        }\r
+        return r;\r
+    };\r
+\r
+    function attrValue(n, attr){\r
+        if(!n.tagName && typeof n.length != "undefined"){\r
+            n = n[0];\r
+        }\r
+        if(!n){\r
+            return null;\r
+        }\r
+        if(attr == "for"){\r
+            return n.htmlFor;\r
+        }\r
+        if(attr == "class" || attr == "className"){\r
+            return n.className;\r
+        }\r
+        return n.getAttribute(attr) || n[attr];\r
+\r
+    };\r
+\r
+    function getNodes(ns, mode, tagName){\r
+        var result = [], ri = -1, cs;\r
+        if(!ns){\r
+            return result;\r
+        }\r
+        tagName = tagName || "*";\r
+        if(typeof ns.getElementsByTagName != "undefined"){\r
+            ns = [ns];\r
+        }\r
+        if(!mode){\r
+            for(var i = 0, ni; ni = ns[i]; i++){\r
+                cs = ni.getElementsByTagName(tagName);\r
+                for(var j = 0, ci; ci = cs[j]; j++){\r
+                    result[++ri] = ci;\r
+                }\r
+            }\r
+        }else if(mode == "/" || mode == ">"){\r
+            var utag = tagName.toUpperCase();\r
+            for(var i = 0, ni, cn; ni = ns[i]; i++){\r
+                cn = isOpera ? ni.childNodes : (ni.children || ni.childNodes);\r
+                for(var j = 0, cj; cj = cn[j]; j++){\r
+                    if(cj.nodeName == utag || cj.nodeName == tagName  || tagName == '*'){\r
+                        result[++ri] = cj;\r
+                    }\r
+                }\r
+            }\r
+        }else if(mode == "+"){\r
+            var utag = tagName.toUpperCase();\r
+            for(var i = 0, n; n = ns[i]; i++){\r
+                while((n = n.nextSibling) && n.nodeType != 1);\r
+                if(n && (n.nodeName == utag || n.nodeName == tagName || tagName == '*')){\r
+                    result[++ri] = n;\r
+                }\r
+            }\r
+        }else if(mode == "~"){\r
+            var utag = tagName.toUpperCase();\r
+            for(var i = 0, n; n = ns[i]; i++){\r
+                while((n = n.nextSibling)){\r
+                    if (n.nodeName == utag || n.nodeName == tagName || tagName == '*'){\r
+                        result[++ri] = n;\r
+                    }\r
+                }\r
+            }\r
+        }\r
+        return result;\r
+    };\r
+\r
+    function concat(a, b){\r
+        if(b.slice){\r
+            return a.concat(b);\r
+        }\r
+        for(var i = 0, l = b.length; i < l; i++){\r
+            a[a.length] = b[i];\r
+        }\r
+        return a;\r
+    }\r
+\r
+    function byTag(cs, tagName){\r
+        if(cs.tagName || cs == document){\r
+            cs = [cs];\r
+        }\r
+        if(!tagName){\r
+            return cs;\r
+        }\r
+        var r = [], ri = -1;\r
+        tagName = tagName.toLowerCase();\r
+        for(var i = 0, ci; ci = cs[i]; i++){\r
+            if(ci.nodeType == 1 && ci.tagName.toLowerCase()==tagName){\r
+                r[++ri] = ci;\r
+            }\r
+        }\r
+        return r;\r
+    };\r
+\r
+    function byId(cs, attr, id){\r
+        if(cs.tagName || cs == document){\r
+            cs = [cs];\r
+        }\r
+        if(!id){\r
+            return cs;\r
+        }\r
+        var r = [], ri = -1;\r
+        for(var i = 0,ci; ci = cs[i]; i++){\r
+            if(ci && ci.id == id){\r
+                r[++ri] = ci;\r
+                return r;\r
+            }\r
+        }\r
+        return r;\r
+    };\r
+\r
+    function byAttribute(cs, attr, value, op, custom){\r
+        var r = [], \r
+               ri = -1, \r
+               st = custom=="{",\r
+               f = Ext.DomQuery.operators[op];\r
+        for(var i = 0, ci; ci = cs[i]; i++){\r
+            if(ci.nodeType != 1){\r
+                continue;\r
+            }\r
+            var a;\r
+            if(st){\r
+                a = Ext.DomQuery.getStyle(ci, attr);\r
+            }\r
+            else if(attr == "class" || attr == "className"){\r
+                a = ci.className;\r
+            }else if(attr == "for"){\r
+                a = ci.htmlFor;\r
+            }else if(attr == "href"){\r
+                a = ci.getAttribute("href", 2);\r
+            }else{\r
+                a = ci.getAttribute(attr);\r
+            }\r
+            if((f && f(a, value)) || (!f && a)){\r
+                r[++ri] = ci;\r
+            }\r
+        }\r
+        return r;\r
+    };\r
+\r
+    function byPseudo(cs, name, value){\r
+        return Ext.DomQuery.pseudos[name](cs, value);\r
+    };\r
+\r
+    function nodupIEXml(cs){\r
+        var d = ++key, \r
+               r;\r
+        cs[0].setAttribute("_nodup", d);\r
+        r = [cs[0]];\r
+        for(var i = 1, len = cs.length; i < len; i++){\r
+            var c = cs[i];\r
+            if(!c.getAttribute("_nodup") != d){\r
+                c.setAttribute("_nodup", d);\r
+                r[r.length] = c;\r
+            }\r
+        }\r
+        for(var i = 0, len = cs.length; i < len; i++){\r
+            cs[i].removeAttribute("_nodup");\r
+        }\r
+        return r;\r
+    }\r
+\r
+    function nodup(cs){\r
+        if(!cs){\r
+            return [];\r
+        }\r
+        var len = cs.length, c, i, r = cs, cj, ri = -1;\r
+        if(!len || typeof cs.nodeType != "undefined" || len == 1){\r
+            return cs;\r
+        }\r
+        if(isIE && typeof cs[0].selectSingleNode != "undefined"){\r
+            return nodupIEXml(cs);\r
+        }\r
+        var d = ++key;\r
+        cs[0]._nodup = d;\r
+        for(i = 1; c = cs[i]; i++){\r
+            if(c._nodup != d){\r
+                c._nodup = d;\r
+            }else{\r
+                r = [];\r
+                for(var j = 0; j < i; j++){\r
+                    r[++ri] = cs[j];\r
+                }\r
+                for(j = i+1; cj = cs[j]; j++){\r
+                    if(cj._nodup != d){\r
+                        cj._nodup = d;\r
+                        r[++ri] = cj;\r
+                    }\r
+                }\r
+                return r;\r
+            }\r
+        }\r
+        return r;\r
+    }\r
+\r
+    function quickDiffIEXml(c1, c2){\r
+        var d = ++key,\r
+               r = [];\r
+        for(var i = 0, len = c1.length; i < len; i++){\r
+            c1[i].setAttribute("_qdiff", d);\r
+        }        \r
+        for(var i = 0, len = c2.length; i < len; i++){\r
+            if(c2[i].getAttribute("_qdiff") != d){\r
+                r[r.length] = c2[i];\r
+            }\r
+        }\r
+        for(var i = 0, len = c1.length; i < len; i++){\r
+           c1[i].removeAttribute("_qdiff");\r
+        }\r
+        return r;\r
+    }\r
+\r
+    function quickDiff(c1, c2){\r
+        var len1 = c1.length,\r
+               d = ++key,\r
+               r = [];\r
+        if(!len1){\r
+            return c2;\r
+        }\r
+        if(isIE && c1[0].selectSingleNode){\r
+            return quickDiffIEXml(c1, c2);\r
+        }        \r
+        for(var i = 0; i < len1; i++){\r
+            c1[i]._qdiff = d;\r
+        }        \r
+        for(var i = 0, len = c2.length; i < len; i++){\r
+            if(c2[i]._qdiff != d){\r
+                r[r.length] = c2[i];\r
+            }\r
+        }\r
+        return r;\r
+    }\r
+\r
+    function quickId(ns, mode, root, id){\r
+        if(ns == root){\r
+           var d = root.ownerDocument || root;\r
+           return d.getElementById(id);\r
+        }\r
+        ns = getNodes(ns, mode, "*");\r
+        return byId(ns, null, id);\r
+    }\r
+\r
+    return {\r
+        getStyle : function(el, name){\r
+            return Ext.fly(el).getStyle(name);\r
+        },\r
+        <div id="method-Ext.DomQuery-compile"></div>/**\r
+         * Compiles a selector/xpath query into a reusable function. The returned function\r
+         * takes one parameter "root" (optional), which is the context node from where the query should start.\r
+         * @param {String} selector The selector/xpath query\r
+         * @param {String} type (optional) Either "select" (the default) or "simple" for a simple selector match\r
+         * @return {Function}\r
+         */\r
+        compile : function(path, type){\r
+            type = type || "select";\r
+\r
+            var fn = ["var f = function(root){\n var mode; ++batch; var n = root || document;\n"],\r
+               q = path, mode, lq,\r
+               tk = Ext.DomQuery.matchers,\r
+               tklen = tk.length,\r
+               mm,\r
+               // accept leading mode switch\r
+               lmode = q.match(modeRe);\r
+            \r
+            if(lmode && lmode[1]){\r
+                fn[fn.length] = 'mode="'+lmode[1].replace(trimRe, "")+'";';\r
+                q = q.replace(lmode[1], "");\r
+            }\r
+            // strip leading slashes\r
+            while(path.substr(0, 1)=="/"){\r
+                path = path.substr(1);\r
+            }\r
+\r
+            while(q && lq != q){\r
+                lq = q;\r
+                var tm = q.match(tagTokenRe);\r
+                if(type == "select"){\r
+                    if(tm){\r
+                        if(tm[1] == "#"){\r
+                            fn[fn.length] = 'n = quickId(n, mode, root, "'+tm[2]+'");';\r
+                        }else{\r
+                            fn[fn.length] = 'n = getNodes(n, mode, "'+tm[2]+'");';\r
+                        }\r
+                        q = q.replace(tm[0], "");\r
+                    }else if(q.substr(0, 1) != '@'){\r
+                        fn[fn.length] = 'n = getNodes(n, mode, "*");';\r
+                    }\r
+                }else{\r
+                    if(tm){\r
+                        if(tm[1] == "#"){\r
+                            fn[fn.length] = 'n = byId(n, null, "'+tm[2]+'");';\r
+                        }else{\r
+                            fn[fn.length] = 'n = byTag(n, "'+tm[2]+'");';\r
+                        }\r
+                        q = q.replace(tm[0], "");\r
+                    }\r
+                }\r
+                while(!(mm = q.match(modeRe))){\r
+                    var matched = false;\r
+                    for(var j = 0; j < tklen; j++){\r
+                        var t = tk[j];\r
+                        var m = q.match(t.re);\r
+                        if(m){\r
+                            fn[fn.length] = t.select.replace(tplRe, function(x, i){\r
+                                                    return m[i];\r
+                                                });\r
+                            q = q.replace(m[0], "");\r
+                            matched = true;\r
+                            break;\r
+                        }\r
+                    }\r
+                    // prevent infinite loop on bad selector\r
+                    if(!matched){\r
+                        throw 'Error parsing selector, parsing failed at "' + q + '"';\r
+                    }\r
+                }\r
+                if(mm[1]){\r
+                    fn[fn.length] = 'mode="'+mm[1].replace(trimRe, "")+'";';\r
+                    q = q.replace(mm[1], "");\r
+                }\r
+            }\r
+            fn[fn.length] = "return nodup(n);\n}";\r
+            eval(fn.join(""));\r
+            return f;\r
+        },\r
+\r
+        <div id="method-Ext.DomQuery-select"></div>/**\r
+         * Selects a group of elements.\r
+         * @param {String} selector The selector/xpath query (can be a comma separated list of selectors)\r
+         * @param {Node} root (optional) The start of the query (defaults to document).\r
+         * @return {Array} An Array of DOM elements which match the selector. If there are\r
+         * no matches, and empty Array is returned.\r
+         */\r
+        select : function(path, root, type){\r
+            if(!root || root == document){\r
+                root = document;\r
+            }\r
+            if(typeof root == "string"){\r
+                root = document.getElementById(root);\r
+            }\r
+            var paths = path.split(","),\r
+               results = [];\r
+            for(var i = 0, len = paths.length; i < len; i++){\r
+                var p = paths[i].replace(trimRe, "");\r
+                if(!cache[p]){\r
+                    cache[p] = Ext.DomQuery.compile(p);\r
+                    if(!cache[p]){\r
+                        throw p + " is not a valid selector";\r
+                    }\r
+                }\r
+                var result = cache[p](root);\r
+                if(result && result != document){\r
+                    results = results.concat(result);\r
+                }\r
+            }\r
+            if(paths.length > 1){\r
+                return nodup(results);\r
+            }\r
+            return results;\r
+        },\r
+\r
+        <div id="method-Ext.DomQuery-selectNode"></div>/**\r
+         * Selects a single element.\r
+         * @param {String} selector The selector/xpath query\r
+         * @param {Node} root (optional) The start of the query (defaults to document).\r
+         * @return {Element} The DOM element which matched the selector.\r
+         */\r
+        selectNode : function(path, root){\r
+            return Ext.DomQuery.select(path, root)[0];\r
+        },\r
+\r
+        <div id="method-Ext.DomQuery-selectValue"></div>/**\r
+         * Selects the value of a node, optionally replacing null with the defaultValue.\r
+         * @param {String} selector The selector/xpath query\r
+         * @param {Node} root (optional) The start of the query (defaults to document).\r
+         * @param {String} defaultValue\r
+         * @return {String}\r
+         */\r
+        selectValue : function(path, root, defaultValue){\r
+            path = path.replace(trimRe, "");\r
+            if(!valueCache[path]){\r
+                valueCache[path] = Ext.DomQuery.compile(path, "select");\r
+            }\r
+            var n = valueCache[path](root),\r
+               v;\r
+            n = n[0] ? n[0] : n;\r
+            v = (n && n.firstChild ? n.firstChild.nodeValue : null);\r
+            return ((v === null||v === undefined||v==='') ? defaultValue : v);\r
+        },\r
+\r
+        <div id="method-Ext.DomQuery-selectNumber"></div>/**\r
+         * Selects the value of a node, parsing integers and floats. Returns the defaultValue, or 0 if none is specified.\r
+         * @param {String} selector The selector/xpath query\r
+         * @param {Node} root (optional) The start of the query (defaults to document).\r
+         * @param {Number} defaultValue\r
+         * @return {Number}\r
+         */\r
+        selectNumber : function(path, root, defaultValue){\r
+            var v = Ext.DomQuery.selectValue(path, root, defaultValue || 0);\r
+            return parseFloat(v);\r
+        },\r
+\r
+        <div id="method-Ext.DomQuery-is"></div>/**\r
+         * Returns true if the passed element(s) match the passed simple selector (e.g. div.some-class or span:first-child)\r
+         * @param {String/HTMLElement/Array} el An element id, element or array of elements\r
+         * @param {String} selector The simple selector to test\r
+         * @return {Boolean}\r
+         */\r
+        is : function(el, ss){\r
+            if(typeof el == "string"){\r
+                el = document.getElementById(el);\r
+            }\r
+            var isArray = Ext.isArray(el),\r
+               result = Ext.DomQuery.filter(isArray ? el : [el], ss);\r
+            return isArray ? (result.length == el.length) : (result.length > 0);\r
+        },\r
+\r
+        <div id="method-Ext.DomQuery-filter"></div>/**\r
+         * Filters an array of elements to only include matches of a simple selector (e.g. div.some-class or span:first-child)\r
+         * @param {Array} el An array of elements to filter\r
+         * @param {String} selector The simple selector to test\r
+         * @param {Boolean} nonMatches If true, it returns the elements that DON'T match\r
+         * the selector instead of the ones that match\r
+         * @return {Array} An Array of DOM elements which match the selector. If there are\r
+         * no matches, and empty Array is returned.\r
+         */\r
+        filter : function(els, ss, nonMatches){\r
+            ss = ss.replace(trimRe, "");\r
+            if(!simpleCache[ss]){\r
+                simpleCache[ss] = Ext.DomQuery.compile(ss, "simple");\r
+            }\r
+            var result = simpleCache[ss](els);\r
+            return nonMatches ? quickDiff(result, els) : result;\r
+        },\r
+\r
+        <div id="prop-Ext.DomQuery-matchers"></div>/**\r
+         * Collection of matching regular expressions and code snippets.\r
+         */\r
+        matchers : [{\r
+                re: /^\.([\w-]+)/,\r
+                select: 'n = byClassName(n, null, " {1} ");'\r
+            }, {\r
+                re: /^\:([\w-]+)(?:\(((?:[^\s>\/]*|.*?))\))?/,\r
+                select: 'n = byPseudo(n, "{1}", "{2}");'\r
+            },{\r
+                re: /^(?:([\[\{])(?:@)?([\w-]+)\s?(?:(=|.=)\s?['"]?(.*?)["']?)?[\]\}])/,\r
+                select: 'n = byAttribute(n, "{2}", "{4}", "{3}", "{1}");'\r
+            }, {\r
+                re: /^#([\w-]+)/,\r
+                select: 'n = byId(n, null, "{1}");'\r
+            },{\r
+                re: /^@([\w-]+)/,\r
+                select: 'return {firstChild:{nodeValue:attrValue(n, "{1}")}};'\r
+            }\r
+        ],\r
+\r
+        <div id="method-Ext.DomQuery-operators"></div>/**\r
+         * Collection of operator comparison functions. The default operators are =, !=, ^=, $=, *=, %=, |= and ~=.\r
+         * New operators can be added as long as the match the format <i>c</i>= where <i>c</i> is any character other than space, &gt; &lt;.\r
+         */\r
+        operators : {\r
+            "=" : function(a, v){\r
+                return a == v;\r
+            },\r
+            "!=" : function(a, v){\r
+                return a != v;\r
+            },\r
+            "^=" : function(a, v){\r
+                return a && a.substr(0, v.length) == v;\r
+            },\r
+            "$=" : function(a, v){\r
+                return a && a.substr(a.length-v.length) == v;\r
+            },\r
+            "*=" : function(a, v){\r
+                return a && a.indexOf(v) !== -1;\r
+            },\r
+            "%=" : function(a, v){\r
+                return (a % v) == 0;\r
+            },\r
+            "|=" : function(a, v){\r
+                return a && (a == v || a.substr(0, v.length+1) == v+'-');\r
+            },\r
+            "~=" : function(a, v){\r
+                return a && (' '+a+' ').indexOf(' '+v+' ') != -1;\r
+            }\r
+        },\r
+\r
+        <div id="prop-Ext.DomQuery-pseudos"></div>/**\r
+         * Collection of "pseudo class" processors. Each processor is passed the current nodeset (array)\r
+         * and the argument (if any) supplied in the selector.\r
+         */\r
+        pseudos : {\r
+            "first-child" : function(c){\r
+                var r = [], ri = -1, n;\r
+                for(var i = 0, ci; ci = n = c[i]; i++){\r
+                    while((n = n.previousSibling) && n.nodeType != 1);\r
+                    if(!n){\r
+                        r[++ri] = ci;\r
+                    }\r
+                }\r
+                return r;\r
+            },\r
+\r
+            "last-child" : function(c){\r
+                var r = [], ri = -1, n;\r
+                for(var i = 0, ci; ci = n = c[i]; i++){\r
+                    while((n = n.nextSibling) && n.nodeType != 1);\r
+                    if(!n){\r
+                        r[++ri] = ci;\r
+                    }\r
+                }\r
+                return r;\r
+            },\r
+\r
+            "nth-child" : function(c, a) {\r
+                var r = [], ri = -1,\r
+                       m = nthRe.exec(a == "even" && "2n" || a == "odd" && "2n+1" || !nthRe2.test(a) && "n+" + a || a),\r
+                       f = (m[1] || 1) - 0, l = m[2] - 0;\r
+                for(var i = 0, n; n = c[i]; i++){\r
+                    var pn = n.parentNode;\r
+                    if (batch != pn._batch) {\r
+                        var j = 0;\r
+                        for(var cn = pn.firstChild; cn; cn = cn.nextSibling){\r
+                            if(cn.nodeType == 1){\r
+                               cn.nodeIndex = ++j;\r
+                            }\r
+                        }\r
+                        pn._batch = batch;\r
+                    }\r
+                    if (f == 1) {\r
+                        if (l == 0 || n.nodeIndex == l){\r
+                            r[++ri] = n;\r
+                        }\r
+                    } else if ((n.nodeIndex + l) % f == 0){\r
+                        r[++ri] = n;\r
+                    }\r
+                }\r
+\r
+                return r;\r
+            },\r
+\r
+            "only-child" : function(c){\r
+                var r = [], ri = -1;;\r
+                for(var i = 0, ci; ci = c[i]; i++){\r
+                    if(!prev(ci) && !next(ci)){\r
+                        r[++ri] = ci;\r
+                    }\r
+                }\r
+                return r;\r
+            },\r
+\r
+            "empty" : function(c){\r
+                var r = [], ri = -1;\r
+                for(var i = 0, ci; ci = c[i]; i++){\r
+                    var cns = ci.childNodes, j = 0, cn, empty = true;\r
+                    while(cn = cns[j]){\r
+                        ++j;\r
+                        if(cn.nodeType == 1 || cn.nodeType == 3){\r
+                            empty = false;\r
+                            break;\r
+                        }\r
+                    }\r
+                    if(empty){\r
+                        r[++ri] = ci;\r
+                    }\r
+                }\r
+                return r;\r
+            },\r
+\r
+            "contains" : function(c, v){\r
+                var r = [], ri = -1;\r
+                for(var i = 0, ci; ci = c[i]; i++){\r
+                    if((ci.textContent||ci.innerText||'').indexOf(v) != -1){\r
+                        r[++ri] = ci;\r
+                    }\r
+                }\r
+                return r;\r
+            },\r
+\r
+            "nodeValue" : function(c, v){\r
+                var r = [], ri = -1;\r
+                for(var i = 0, ci; ci = c[i]; i++){\r
+                    if(ci.firstChild && ci.firstChild.nodeValue == v){\r
+                        r[++ri] = ci;\r
+                    }\r
+                }\r
+                return r;\r
+            },\r
+\r
+            "checked" : function(c){\r
+                var r = [], ri = -1;\r
+                for(var i = 0, ci; ci = c[i]; i++){\r
+                    if(ci.checked == true){\r
+                        r[++ri] = ci;\r
+                    }\r
+                }\r
+                return r;\r
+            },\r
+\r
+            "not" : function(c, ss){\r
+                return Ext.DomQuery.filter(c, ss, true);\r
+            },\r
+\r
+            "any" : function(c, selectors){\r
+                var ss = selectors.split('|'),\r
+                       r = [], ri = -1, s;\r
+                for(var i = 0, ci; ci = c[i]; i++){\r
+                    for(var j = 0; s = ss[j]; j++){\r
+                        if(Ext.DomQuery.is(ci, s)){\r
+                            r[++ri] = ci;\r
+                            break;\r
+                        }\r
+                    }\r
+                }\r
+                return r;\r
+            },\r
+\r
+            "odd" : function(c){\r
+                return this["nth-child"](c, "odd");\r
+            },\r
+\r
+            "even" : function(c){\r
+                return this["nth-child"](c, "even");\r
+            },\r
+\r
+            "nth" : function(c, a){\r
+                return c[a-1] || [];\r
+            },\r
+\r
+            "first" : function(c){\r
+                return c[0] || [];\r
+            },\r
+\r
+            "last" : function(c){\r
+                return c[c.length-1] || [];\r
+            },\r
+\r
+            "has" : function(c, ss){\r
+                var s = Ext.DomQuery.select,\r
+                       r = [], ri = -1;\r
+                for(var i = 0, ci; ci = c[i]; i++){\r
+                    if(s(ss, ci).length > 0){\r
+                        r[++ri] = ci;\r
+                    }\r
+                }\r
+                return r;\r
+            },\r
+\r
+            "next" : function(c, ss){\r
+                var is = Ext.DomQuery.is,\r
+                       r = [], ri = -1;\r
+                for(var i = 0, ci; ci = c[i]; i++){\r
+                    var n = next(ci);\r
+                    if(n && is(n, ss)){\r
+                        r[++ri] = ci;\r
+                    }\r
+                }\r
+                return r;\r
+            },\r
+\r
+            "prev" : function(c, ss){\r
+                var is = Ext.DomQuery.is,\r
+                       r = [], ri = -1;\r
+                for(var i = 0, ci; ci = c[i]; i++){\r
+                    var n = prev(ci);\r
+                    if(n && is(n, ss)){\r
+                        r[++ri] = ci;\r
+                    }\r
+                }\r
+                return r;\r
+            }\r
+        }\r
+    };\r
+}();\r
+\r
+<div id="method-Ext-query"></div>/**\r
+ * Selects an array of DOM nodes by CSS/XPath selector. Shorthand of {@link Ext.DomQuery#select}\r
+ * @param {String} path The selector/xpath query\r
+ * @param {Node} root (optional) The start of the query (defaults to document).\r
+ * @return {Array}\r
+ * @member Ext\r
+ * @method query\r
+ */\r
+Ext.query = Ext.DomQuery.select;\r
+</pre>    \r
+</body>\r
+</html>
\ No newline at end of file