docs/source/DomQuery.html

   1 <!DOCTYPE html>
   2 <html>
   3 <head>
   4   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   5   <title>The source code</title>
   6   <link href="../prettify/prettify.css" type="text/css" rel="stylesheet" />
   7   <script type="text/javascript" src="../prettify/prettify.js"></script>
   8   <style type="text/css">
   9     .highlight { display: block; background-color: #ddd; }
  10   </style>
  11   <script type="text/javascript">
  12     function highlight() {
  13       document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
  14     }
  15   </script>
  16 </head>
  17 <body onload="prettyPrint(); highlight();">
  18   <pre class="prettyprint lang-js">/*
  19  * This is code is also distributed under MIT license for use
  20  * with jQuery and prototype JavaScript libraries.
  21  */
  22 <span id='Ext-DomQuery'>/**
  23 </span> * @class Ext.DomQuery
  24 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).
  25 &lt;p&gt;
  26 DomQuery supports most of the &lt;a href=&quot;http://www.w3.org/TR/2005/WD-css3-selectors-20051215/#selectors&quot;&gt;CSS3 selectors spec&lt;/a&gt;, along with some custom selectors and basic XPath.&lt;/p&gt;
  27
  28 &lt;p&gt;
  29 All selectors, attribute filters and pseudos below can be combined infinitely in any order. For example &quot;div.foo:nth-child(odd)[@foo=bar].bar:first&quot; 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.
  30 &lt;/p&gt;
  31 &lt;h4&gt;Element Selectors:&lt;/h4&gt;
  32 &lt;ul class=&quot;list&quot;&gt;
  33     &lt;li&gt; &lt;b&gt;*&lt;/b&gt; any element&lt;/li&gt;
  34     &lt;li&gt; &lt;b&gt;E&lt;/b&gt; an element with the tag E&lt;/li&gt;
  35     &lt;li&gt; &lt;b&gt;E F&lt;/b&gt; All descendent elements of E that have the tag F&lt;/li&gt;
  36     &lt;li&gt; &lt;b&gt;E &gt; F&lt;/b&gt; or &lt;b&gt;E/F&lt;/b&gt; all direct children elements of E that have the tag F&lt;/li&gt;
  37     &lt;li&gt; &lt;b&gt;E + F&lt;/b&gt; all elements with the tag F that are immediately preceded by an element with the tag E&lt;/li&gt;
  38     &lt;li&gt; &lt;b&gt;E ~ F&lt;/b&gt; all elements with the tag F that are preceded by a sibling element with the tag E&lt;/li&gt;
  39 &lt;/ul&gt;
  40 &lt;h4&gt;Attribute Selectors:&lt;/h4&gt;
  41 &lt;p&gt;The use of &amp;#64; and quotes are optional. For example, div[&amp;#64;foo='bar'] is also a valid attribute selector.&lt;/p&gt;
  42 &lt;ul class=&quot;list&quot;&gt;
  43     &lt;li&gt; &lt;b&gt;E[foo]&lt;/b&gt; has an attribute &quot;foo&quot;&lt;/li&gt;
  44     &lt;li&gt; &lt;b&gt;E[foo=bar]&lt;/b&gt; has an attribute &quot;foo&quot; that equals &quot;bar&quot;&lt;/li&gt;
  45     &lt;li&gt; &lt;b&gt;E[foo^=bar]&lt;/b&gt; has an attribute &quot;foo&quot; that starts with &quot;bar&quot;&lt;/li&gt;
  46     &lt;li&gt; &lt;b&gt;E[foo$=bar]&lt;/b&gt; has an attribute &quot;foo&quot; that ends with &quot;bar&quot;&lt;/li&gt;
  47     &lt;li&gt; &lt;b&gt;E[foo*=bar]&lt;/b&gt; has an attribute &quot;foo&quot; that contains the substring &quot;bar&quot;&lt;/li&gt;
  48     &lt;li&gt; &lt;b&gt;E[foo%=2]&lt;/b&gt; has an attribute &quot;foo&quot; that is evenly divisible by 2&lt;/li&gt;
  49     &lt;li&gt; &lt;b&gt;E[foo!=bar]&lt;/b&gt; attribute &quot;foo&quot; does not equal &quot;bar&quot;&lt;/li&gt;
  50 &lt;/ul&gt;
  51 &lt;h4&gt;Pseudo Classes:&lt;/h4&gt;
  52 &lt;ul class=&quot;list&quot;&gt;
  53     &lt;li&gt; &lt;b&gt;E:first-child&lt;/b&gt; E is the first child of its parent&lt;/li&gt;
  54     &lt;li&gt; &lt;b&gt;E:last-child&lt;/b&gt; E is the last child of its parent&lt;/li&gt;
  55     &lt;li&gt; &lt;b&gt;E:nth-child(&lt;i&gt;n&lt;/i&gt;)&lt;/b&gt; E is the &lt;i&gt;n&lt;/i&gt;th child of its parent (1 based as per the spec)&lt;/li&gt;
  56     &lt;li&gt; &lt;b&gt;E:nth-child(odd)&lt;/b&gt; E is an odd child of its parent&lt;/li&gt;
  57     &lt;li&gt; &lt;b&gt;E:nth-child(even)&lt;/b&gt; E is an even child of its parent&lt;/li&gt;
  58     &lt;li&gt; &lt;b&gt;E:only-child&lt;/b&gt; E is the only child of its parent&lt;/li&gt;
  59     &lt;li&gt; &lt;b&gt;E:checked&lt;/b&gt; E is an element that is has a checked attribute that is true (e.g. a radio or checkbox) &lt;/li&gt;
  60     &lt;li&gt; &lt;b&gt;E:first&lt;/b&gt; the first E in the resultset&lt;/li&gt;
  61     &lt;li&gt; &lt;b&gt;E:last&lt;/b&gt; the last E in the resultset&lt;/li&gt;
  62     &lt;li&gt; &lt;b&gt;E:nth(&lt;i&gt;n&lt;/i&gt;)&lt;/b&gt; the &lt;i&gt;n&lt;/i&gt;th E in the resultset (1 based)&lt;/li&gt;
  63     &lt;li&gt; &lt;b&gt;E:odd&lt;/b&gt; shortcut for :nth-child(odd)&lt;/li&gt;
  64     &lt;li&gt; &lt;b&gt;E:even&lt;/b&gt; shortcut for :nth-child(even)&lt;/li&gt;
  65     &lt;li&gt; &lt;b&gt;E:contains(foo)&lt;/b&gt; E's innerHTML contains the substring &quot;foo&quot;&lt;/li&gt;
  66     &lt;li&gt; &lt;b&gt;E:nodeValue(foo)&lt;/b&gt; E contains a textNode with a nodeValue that equals &quot;foo&quot;&lt;/li&gt;
  67     &lt;li&gt; &lt;b&gt;E:not(S)&lt;/b&gt; an E element that does not match simple selector S&lt;/li&gt;
  68     &lt;li&gt; &lt;b&gt;E:has(S)&lt;/b&gt; an E element that has a descendent that matches simple selector S&lt;/li&gt;
  69     &lt;li&gt; &lt;b&gt;E:next(S)&lt;/b&gt; an E element whose next sibling matches simple selector S&lt;/li&gt;
  70     &lt;li&gt; &lt;b&gt;E:prev(S)&lt;/b&gt; an E element whose previous sibling matches simple selector S&lt;/li&gt;
  71     &lt;li&gt; &lt;b&gt;E:any(S1|S2|S2)&lt;/b&gt; an E element which matches any of the simple selectors S1, S2 or S3//\\&lt;/li&gt;
  72 &lt;/ul&gt;
  73 &lt;h4&gt;CSS Value Selectors:&lt;/h4&gt;
  74 &lt;ul class=&quot;list&quot;&gt;
  75     &lt;li&gt; &lt;b&gt;E{display=none}&lt;/b&gt; css value &quot;display&quot; that equals &quot;none&quot;&lt;/li&gt;
  76     &lt;li&gt; &lt;b&gt;E{display^=none}&lt;/b&gt; css value &quot;display&quot; that starts with &quot;none&quot;&lt;/li&gt;
  77     &lt;li&gt; &lt;b&gt;E{display$=none}&lt;/b&gt; css value &quot;display&quot; that ends with &quot;none&quot;&lt;/li&gt;
  78     &lt;li&gt; &lt;b&gt;E{display*=none}&lt;/b&gt; css value &quot;display&quot; that contains the substring &quot;none&quot;&lt;/li&gt;
  79     &lt;li&gt; &lt;b&gt;E{display%=2}&lt;/b&gt; css value &quot;display&quot; that is evenly divisible by 2&lt;/li&gt;
  80     &lt;li&gt; &lt;b&gt;E{display!=none}&lt;/b&gt; css value &quot;display&quot; that does not equal &quot;none&quot;&lt;/li&gt;
  81 &lt;/ul&gt;
  82  * @singleton
  83  */
  84 Ext.ns('Ext.core');
  85
  86 Ext.core.DomQuery = Ext.DomQuery = function(){
  87     var cache = {},
  88         simpleCache = {},
  89         valueCache = {},
  90         nonSpace = /\S/,
  91         trimRe = /^\s+|\s+$/g,
  92         tplRe = /\{(\d+)\}/g,
  93         modeRe = /^(\s?[\/&gt;+~]\s?|\s|$)/,
  94         tagTokenRe = /^(#)?([\w-\*]+)/,
  95         nthRe = /(\d*)n\+?(\d*)/,
  96         nthRe2 = /\D/,
  97         // This is for IE MSXML which does not support expandos.
  98     // IE runs the same speed using setAttribute, however FF slows way down
  99     // and Safari completely fails so they need to continue to use expandos.
 100     isIE = window.ActiveXObject ? true : false,
 101     key = 30803;
 102
 103     // this eval is stop the compressor from
 104     // renaming the variable to something shorter
 105     eval(&quot;var batch = 30803;&quot;);
 106
 107     // Retrieve the child node from a particular
 108     // parent at the specified index.
 109     function child(parent, index){
 110         var i = 0,
 111             n = parent.firstChild;
 112         while(n){
 113             if(n.nodeType == 1){
 114                if(++i == index){
 115                    return n;
 116                }
 117             }
 118             n = n.nextSibling;
 119         }
 120         return null;
 121     }
 122
 123     // retrieve the next element node
 124     function next(n){
 125         while((n = n.nextSibling) &amp;&amp; n.nodeType != 1);
 126         return n;
 127     }
 128
 129     // retrieve the previous element node
 130     function prev(n){
 131         while((n = n.previousSibling) &amp;&amp; n.nodeType != 1);
 132         return n;
 133     }
 134
 135     // Mark each child node with a nodeIndex skipping and
 136     // removing empty text nodes.
 137     function children(parent){
 138         var n = parent.firstChild,
 139         nodeIndex = -1,
 140         nextNode;
 141         while(n){
 142             nextNode = n.nextSibling;
 143             // clean worthless empty nodes.
 144             if(n.nodeType == 3 &amp;&amp; !nonSpace.test(n.nodeValue)){
 145             parent.removeChild(n);
 146             }else{
 147             // add an expando nodeIndex
 148             n.nodeIndex = ++nodeIndex;
 149             }
 150             n = nextNode;
 151         }
 152         return this;
 153     }
 154
 155
 156     // nodeSet - array of nodes
 157     // cls - CSS Class
 158     function byClassName(nodeSet, cls){
 159         if(!cls){
 160             return nodeSet;
 161         }
 162         var result = [], ri = -1;
 163         for(var i = 0, ci; ci = nodeSet[i]; i++){
 164             if((' '+ci.className+' ').indexOf(cls) != -1){
 165                 result[++ri] = ci;
 166             }
 167         }
 168         return result;
 169     };
 170
 171     function attrValue(n, attr){
 172         // if its an array, use the first node.
 173         if(!n.tagName &amp;&amp; typeof n.length != &quot;undefined&quot;){
 174             n = n[0];
 175         }
 176         if(!n){
 177             return null;
 178         }
 179
 180         if(attr == &quot;for&quot;){
 181             return n.htmlFor;
 182         }
 183         if(attr == &quot;class&quot; || attr == &quot;className&quot;){
 184             return n.className;
 185         }
 186         return n.getAttribute(attr) || n[attr];
 187
 188     };
 189
 190
 191     // ns - nodes
 192     // mode - false, /, &gt;, +, ~
 193     // tagName - defaults to &quot;*&quot;
 194     function getNodes(ns, mode, tagName){
 195         var result = [], ri = -1, cs;
 196         if(!ns){
 197             return result;
 198         }
 199         tagName = tagName || &quot;*&quot;;
 200         // convert to array
 201         if(typeof ns.getElementsByTagName != &quot;undefined&quot;){
 202             ns = [ns];
 203         }
 204
 205         // no mode specified, grab all elements by tagName
 206         // at any depth
 207         if(!mode){
 208             for(var i = 0, ni; ni = ns[i]; i++){
 209                 cs = ni.getElementsByTagName(tagName);
 210                 for(var j = 0, ci; ci = cs[j]; j++){
 211                     result[++ri] = ci;
 212                 }
 213             }
 214         // Direct Child mode (/ or &gt;)
 215         // E &gt; F or E/F all direct children elements of E that have the tag
 216         } else if(mode == &quot;/&quot; || mode == &quot;&gt;&quot;){
 217             var utag = tagName.toUpperCase();
 218             for(var i = 0, ni, cn; ni = ns[i]; i++){
 219                 cn = ni.childNodes;
 220                 for(var j = 0, cj; cj = cn[j]; j++){
 221                     if(cj.nodeName == utag || cj.nodeName == tagName  || tagName == '*'){
 222                         result[++ri] = cj;
 223                     }
 224                 }
 225             }
 226         // Immediately Preceding mode (+)
 227         // E + F all elements with the tag F that are immediately preceded by an element with the tag E
 228         }else if(mode == &quot;+&quot;){
 229             var utag = tagName.toUpperCase();
 230             for(var i = 0, n; n = ns[i]; i++){
 231                 while((n = n.nextSibling) &amp;&amp; n.nodeType != 1);
 232                 if(n &amp;&amp; (n.nodeName == utag || n.nodeName == tagName || tagName == '*')){
 233                     result[++ri] = n;
 234                 }
 235             }
 236         // Sibling mode (~)
 237         // E ~ F all elements with the tag F that are preceded by a sibling element with the tag E
 238         }else if(mode == &quot;~&quot;){
 239             var utag = tagName.toUpperCase();
 240             for(var i = 0, n; n = ns[i]; i++){
 241                 while((n = n.nextSibling)){
 242                     if (n.nodeName == utag || n.nodeName == tagName || tagName == '*'){
 243                         result[++ri] = n;
 244                     }
 245                 }
 246             }
 247         }
 248         return result;
 249     }
 250
 251     function concat(a, b){
 252         if(b.slice){
 253             return a.concat(b);
 254         }
 255         for(var i = 0, l = b.length; i &lt; l; i++){
 256             a[a.length] = b[i];
 257         }
 258         return a;
 259     }
 260
 261     function byTag(cs, tagName){
 262         if(cs.tagName || cs == document){
 263             cs = [cs];
 264         }
 265         if(!tagName){
 266             return cs;
 267         }
 268         var result = [], ri = -1;
 269         tagName = tagName.toLowerCase();
 270         for(var i = 0, ci; ci = cs[i]; i++){
 271             if(ci.nodeType == 1 &amp;&amp; ci.tagName.toLowerCase() == tagName){
 272                 result[++ri] = ci;
 273             }
 274         }
 275         return result;
 276     }
 277
 278     function byId(cs, id){
 279         if(cs.tagName || cs == document){
 280             cs = [cs];
 281         }
 282         if(!id){
 283             return cs;
 284         }
 285         var result = [], ri = -1;
 286         for(var i = 0, ci; ci = cs[i]; i++){
 287             if(ci &amp;&amp; ci.id == id){
 288                 result[++ri] = ci;
 289                 return result;
 290             }
 291         }
 292         return result;
 293     }
 294
 295     // operators are =, !=, ^=, $=, *=, %=, |= and ~=
 296     // custom can be &quot;{&quot;
 297     function byAttribute(cs, attr, value, op, custom){
 298         var result = [],
 299             ri = -1,
 300             useGetStyle = custom == &quot;{&quot;,
 301             fn = Ext.DomQuery.operators[op],
 302             a,
 303             xml,
 304             hasXml;
 305
 306         for(var i = 0, ci; ci = cs[i]; i++){
 307             // skip non-element nodes.
 308             if(ci.nodeType != 1){
 309                 continue;
 310             }
 311             // only need to do this for the first node
 312             if(!hasXml){
 313                 xml = Ext.DomQuery.isXml(ci);
 314                 hasXml = true;
 315             }
 316
 317             // we only need to change the property names if we're dealing with html nodes, not XML
 318             if(!xml){
 319                 if(useGetStyle){
 320                     a = Ext.DomQuery.getStyle(ci, attr);
 321                 } else if (attr == &quot;class&quot; || attr == &quot;className&quot;){
 322                     a = ci.className;
 323                 } else if (attr == &quot;for&quot;){
 324                     a = ci.htmlFor;
 325                 } else if (attr == &quot;href&quot;){
 326                     // getAttribute href bug
 327                     // http://www.glennjones.net/Post/809/getAttributehrefbug.htm
 328                     a = ci.getAttribute(&quot;href&quot;, 2);
 329                 } else{
 330                     a = ci.getAttribute(attr);
 331                 }
 332             }else{
 333                 a = ci.getAttribute(attr);
 334             }
 335             if((fn &amp;&amp; fn(a, value)) || (!fn &amp;&amp; a)){
 336                 result[++ri] = ci;
 337             }
 338         }
 339         return result;
 340     }
 341
 342     function byPseudo(cs, name, value){
 343         return Ext.DomQuery.pseudos[name](cs, value);
 344     }
 345
 346     function nodupIEXml(cs){
 347         var d = ++key,
 348             r;
 349         cs[0].setAttribute(&quot;_nodup&quot;, d);
 350         r = [cs[0]];
 351         for(var i = 1, len = cs.length; i &lt; len; i++){
 352             var c = cs[i];
 353             if(!c.getAttribute(&quot;_nodup&quot;) != d){
 354                 c.setAttribute(&quot;_nodup&quot;, d);
 355                 r[r.length] = c;
 356             }
 357         }
 358         for(var i = 0, len = cs.length; i &lt; len; i++){
 359             cs[i].removeAttribute(&quot;_nodup&quot;);
 360         }
 361         return r;
 362     }
 363
 364     function nodup(cs){
 365         if(!cs){
 366             return [];
 367         }
 368         var len = cs.length, c, i, r = cs, cj, ri = -1;
 369         if(!len || typeof cs.nodeType != &quot;undefined&quot; || len == 1){
 370             return cs;
 371         }
 372         if(isIE &amp;&amp; typeof cs[0].selectSingleNode != &quot;undefined&quot;){
 373             return nodupIEXml(cs);
 374         }
 375         var d = ++key;
 376         cs[0]._nodup = d;
 377         for(i = 1; c = cs[i]; i++){
 378             if(c._nodup != d){
 379                 c._nodup = d;
 380             }else{
 381                 r = [];
 382                 for(var j = 0; j &lt; i; j++){
 383                     r[++ri] = cs[j];
 384                 }
 385                 for(j = i+1; cj = cs[j]; j++){
 386                     if(cj._nodup != d){
 387                         cj._nodup = d;
 388                         r[++ri] = cj;
 389                     }
 390                 }
 391                 return r;
 392             }
 393         }
 394         return r;
 395     }
 396
 397     function quickDiffIEXml(c1, c2){
 398         var d = ++key,
 399             r = [];
 400         for(var i = 0, len = c1.length; i &lt; len; i++){
 401             c1[i].setAttribute(&quot;_qdiff&quot;, d);
 402         }
 403         for(var i = 0, len = c2.length; i &lt; len; i++){
 404             if(c2[i].getAttribute(&quot;_qdiff&quot;) != d){
 405                 r[r.length] = c2[i];
 406             }
 407         }
 408         for(var i = 0, len = c1.length; i &lt; len; i++){
 409            c1[i].removeAttribute(&quot;_qdiff&quot;);
 410         }
 411         return r;
 412     }
 413
 414     function quickDiff(c1, c2){
 415         var len1 = c1.length,
 416             d = ++key,
 417             r = [];
 418         if(!len1){
 419             return c2;
 420         }
 421         if(isIE &amp;&amp; typeof c1[0].selectSingleNode != &quot;undefined&quot;){
 422             return quickDiffIEXml(c1, c2);
 423         }
 424         for(var i = 0; i &lt; len1; i++){
 425             c1[i]._qdiff = d;
 426         }
 427         for(var i = 0, len = c2.length; i &lt; len; i++){
 428             if(c2[i]._qdiff != d){
 429                 r[r.length] = c2[i];
 430             }
 431         }
 432         return r;
 433     }
 434
 435     function quickId(ns, mode, root, id){
 436         if(ns == root){
 437            var d = root.ownerDocument || root;
 438            return d.getElementById(id);
 439         }
 440         ns = getNodes(ns, mode, &quot;*&quot;);
 441         return byId(ns, id);
 442     }
 443
 444     return {
 445         getStyle : function(el, name){
 446             return Ext.fly(el).getStyle(name);
 447         },
 448 <span id='Ext-DomQuery-method-compile'>        /**
 449 </span>         * Compiles a selector/xpath query into a reusable function. The returned function
 450          * takes one parameter &quot;root&quot; (optional), which is the context node from where the query should start.
 451          * @param {String} selector The selector/xpath query
 452          * @param {String} type (optional) Either &quot;select&quot; (the default) or &quot;simple&quot; for a simple selector match
 453          * @return {Function}
 454          */
 455         compile : function(path, type){
 456             type = type || &quot;select&quot;;
 457
 458             // setup fn preamble
 459             var fn = [&quot;var f = function(root){\n var mode; ++batch; var n = root || document;\n&quot;],
 460                 mode,
 461                 lastPath,
 462                 matchers = Ext.DomQuery.matchers,
 463                 matchersLn = matchers.length,
 464                 modeMatch,
 465                 // accept leading mode switch
 466                 lmode = path.match(modeRe);
 467
 468             if(lmode &amp;&amp; lmode[1]){
 469                 fn[fn.length] = 'mode=&quot;'+lmode[1].replace(trimRe, &quot;&quot;)+'&quot;;';
 470                 path = path.replace(lmode[1], &quot;&quot;);
 471             }
 472
 473             // strip leading slashes
 474             while(path.substr(0, 1)==&quot;/&quot;){
 475                 path = path.substr(1);
 476             }
 477
 478             while(path &amp;&amp; lastPath != path){
 479                 lastPath = path;
 480                 var tokenMatch = path.match(tagTokenRe);
 481                 if(type == &quot;select&quot;){
 482                     if(tokenMatch){
 483                         // ID Selector
 484                         if(tokenMatch[1] == &quot;#&quot;){
 485                             fn[fn.length] = 'n = quickId(n, mode, root, &quot;'+tokenMatch[2]+'&quot;);';
 486                         }else{
 487                             fn[fn.length] = 'n = getNodes(n, mode, &quot;'+tokenMatch[2]+'&quot;);';
 488                         }
 489                         path = path.replace(tokenMatch[0], &quot;&quot;);
 490                     }else if(path.substr(0, 1) != '@'){
 491                         fn[fn.length] = 'n = getNodes(n, mode, &quot;*&quot;);';
 492                     }
 493                 // type of &quot;simple&quot;
 494                 }else{
 495                     if(tokenMatch){
 496                         if(tokenMatch[1] == &quot;#&quot;){
 497                             fn[fn.length] = 'n = byId(n, &quot;'+tokenMatch[2]+'&quot;);';
 498                         }else{
 499                             fn[fn.length] = 'n = byTag(n, &quot;'+tokenMatch[2]+'&quot;);';
 500                         }
 501                         path = path.replace(tokenMatch[0], &quot;&quot;);
 502                     }
 503                 }
 504                 while(!(modeMatch = path.match(modeRe))){
 505                     var matched = false;
 506                     for(var j = 0; j &lt; matchersLn; j++){
 507                         var t = matchers[j];
 508                         var m = path.match(t.re);
 509                         if(m){
 510                             fn[fn.length] = t.select.replace(tplRe, function(x, i){
 511                                 return m[i];
 512                             });
 513                             path = path.replace(m[0], &quot;&quot;);
 514                             matched = true;
 515                             break;
 516                         }
 517                     }
 518                     // prevent infinite loop on bad selector
 519                     if(!matched){
 520                         //&lt;debug&gt;
 521                         Ext.Error.raise({
 522                             sourceClass: 'Ext.DomQuery',
 523                             sourceMethod: 'compile',
 524                             msg: 'Error parsing selector. Parsing failed at &quot;' + path + '&quot;'
 525                         });
 526                         //&lt;/debug&gt;
 527                     }
 528                 }
 529                 if(modeMatch[1]){
 530                     fn[fn.length] = 'mode=&quot;'+modeMatch[1].replace(trimRe, &quot;&quot;)+'&quot;;';
 531                     path = path.replace(modeMatch[1], &quot;&quot;);
 532                 }
 533             }
 534             // close fn out
 535             fn[fn.length] = &quot;return nodup(n);\n}&quot;;
 536
 537             // eval fn and return it
 538             eval(fn.join(&quot;&quot;));
 539             return f;
 540         },
 541
 542 <span id='Ext-DomQuery-method-jsSelect'>        /**
 543 </span>         * Selects an array of DOM nodes using JavaScript-only implementation.
 544          *
 545          * Use {@link #select} to take advantage of browsers built-in support for CSS selectors.
 546          *
 547          * @param {String} selector The selector/xpath query (can be a comma separated list of selectors)
 548          * @param {Node/String} root (optional) The start of the query (defaults to document).
 549          * @return {Array} An Array of DOM elements which match the selector. If there are
 550          * no matches, and empty Array is returned.
 551          */
 552         jsSelect: function(path, root, type){
 553             // set root to doc if not specified.
 554             root = root || document;
 555
 556             if(typeof root == &quot;string&quot;){
 557                 root = document.getElementById(root);
 558             }
 559             var paths = path.split(&quot;,&quot;),
 560                 results = [];
 561
 562             // loop over each selector
 563             for(var i = 0, len = paths.length; i &lt; len; i++){
 564                 var subPath = paths[i].replace(trimRe, &quot;&quot;);
 565                 // compile and place in cache
 566                 if(!cache[subPath]){
 567                     cache[subPath] = Ext.DomQuery.compile(subPath);
 568                     if(!cache[subPath]){
 569                         //&lt;debug&gt;
 570                         Ext.Error.raise({
 571                             sourceClass: 'Ext.DomQuery',
 572                             sourceMethod: 'jsSelect',
 573                             msg: subPath + ' is not a valid selector'
 574                         });
 575                         //&lt;/debug&gt;
 576                     }
 577                 }
 578                 var result = cache[subPath](root);
 579                 if(result &amp;&amp; result != document){
 580                     results = results.concat(result);
 581                 }
 582             }
 583
 584             // if there were multiple selectors, make sure dups
 585             // are eliminated
 586             if(paths.length &gt; 1){
 587                 return nodup(results);
 588             }
 589             return results;
 590         },
 591
 592         isXml: function(el) {
 593             var docEl = (el ? el.ownerDocument || el : 0).documentElement;
 594             return docEl ? docEl.nodeName !== &quot;HTML&quot; : false;
 595         },
 596
 597 <span id='Ext-DomQuery-method-select'>        /**
 598 </span>         * Selects an array of DOM nodes by CSS/XPath selector.
 599          *
 600          * Uses [document.querySelectorAll][0] if browser supports that, otherwise falls back to
 601          * {@link #jsSelect} to do the work.
 602          *
 603          * Aliased as {@link Ext#query}.
 604          *
 605          * [0]: https://developer.mozilla.org/en/DOM/document.querySelectorAll
 606          *
 607          * @param {String} path The selector/xpath query
 608          * @param {Node} root (optional) The start of the query (defaults to document).
 609          * @return {Array} An array of DOM elements (not a NodeList as returned by `querySelectorAll`).
 610          * Empty array when no matches.
 611          * @method
 612          */
 613         select : document.querySelectorAll ? function(path, root, type) {
 614             root = root || document;
 615             if (!Ext.DomQuery.isXml(root)) {
 616             try {
 617                 var cs = root.querySelectorAll(path);
 618                 return Ext.Array.toArray(cs);
 619             }
 620             catch (ex) {}
 621             }
 622             return Ext.DomQuery.jsSelect.call(this, path, root, type);
 623         } : function(path, root, type) {
 624             return Ext.DomQuery.jsSelect.call(this, path, root, type);
 625         },
 626
 627 <span id='Ext-DomQuery-method-selectNode'>        /**
 628 </span>         * Selects a single element.
 629          * @param {String} selector The selector/xpath query
 630          * @param {Node} root (optional) The start of the query (defaults to document).
 631          * @return {Element} The DOM element which matched the selector.
 632          */
 633         selectNode : function(path, root){
 634             return Ext.DomQuery.select(path, root)[0];
 635         },
 636
 637 <span id='Ext-DomQuery-method-selectValue'>        /**
 638 </span>         * Selects the value of a node, optionally replacing null with the defaultValue.
 639          * @param {String} selector The selector/xpath query
 640          * @param {Node} root (optional) The start of the query (defaults to document).
 641          * @param {String} defaultValue
 642          * @return {String}
 643          */
 644         selectValue : function(path, root, defaultValue){
 645             path = path.replace(trimRe, &quot;&quot;);
 646             if(!valueCache[path]){
 647                 valueCache[path] = Ext.DomQuery.compile(path, &quot;select&quot;);
 648             }
 649             var n = valueCache[path](root), v;
 650             n = n[0] ? n[0] : n;
 651
 652             // overcome a limitation of maximum textnode size
 653             // Rumored to potentially crash IE6 but has not been confirmed.
 654             // http://reference.sitepoint.com/javascript/Node/normalize
 655             // https://developer.mozilla.org/En/DOM/Node.normalize
 656             if (typeof n.normalize == 'function') n.normalize();
 657
 658             v = (n &amp;&amp; n.firstChild ? n.firstChild.nodeValue : null);
 659             return ((v === null||v === undefined||v==='') ? defaultValue : v);
 660         },
 661
 662 <span id='Ext-DomQuery-method-selectNumber'>        /**
 663 </span>         * Selects the value of a node, parsing integers and floats. Returns the defaultValue, or 0 if none is specified.
 664          * @param {String} selector The selector/xpath query
 665          * @param {Node} root (optional) The start of the query (defaults to document).
 666          * @param {Number} defaultValue
 667          * @return {Number}
 668          */
 669         selectNumber : function(path, root, defaultValue){
 670             var v = Ext.DomQuery.selectValue(path, root, defaultValue || 0);
 671             return parseFloat(v);
 672         },
 673
 674 <span id='Ext-DomQuery-method-is'>        /**
 675 </span>         * Returns true if the passed element(s) match the passed simple selector (e.g. div.some-class or span:first-child)
 676          * @param {String/HTMLElement/Array} el An element id, element or array of elements
 677          * @param {String} selector The simple selector to test
 678          * @return {Boolean}
 679          */
 680         is : function(el, ss){
 681             if(typeof el == &quot;string&quot;){
 682                 el = document.getElementById(el);
 683             }
 684             var isArray = Ext.isArray(el),
 685                 result = Ext.DomQuery.filter(isArray ? el : [el], ss);
 686             return isArray ? (result.length == el.length) : (result.length &gt; 0);
 687         },
 688
 689 <span id='Ext-DomQuery-method-filter'>        /**
 690 </span>         * Filters an array of elements to only include matches of a simple selector (e.g. div.some-class or span:first-child)
 691          * @param {Array} el An array of elements to filter
 692          * @param {String} selector The simple selector to test
 693          * @param {Boolean} nonMatches If true, it returns the elements that DON'T match
 694          * the selector instead of the ones that match
 695          * @return {Array} An Array of DOM elements which match the selector. If there are
 696          * no matches, and empty Array is returned.
 697          */
 698         filter : function(els, ss, nonMatches){
 699             ss = ss.replace(trimRe, &quot;&quot;);
 700             if(!simpleCache[ss]){
 701                 simpleCache[ss] = Ext.DomQuery.compile(ss, &quot;simple&quot;);
 702             }
 703             var result = simpleCache[ss](els);
 704             return nonMatches ? quickDiff(result, els) : result;
 705         },
 706
 707 <span id='Ext-DomQuery-property-matchers'>        /**
 708 </span>         * Collection of matching regular expressions and code snippets.
 709          * Each capture group within () will be replace the {} in the select
 710          * statement as specified by their index.
 711          */
 712         matchers : [{
 713                 re: /^\.([\w-]+)/,
 714                 select: 'n = byClassName(n, &quot; {1} &quot;);'
 715             }, {
 716                 re: /^\:([\w-]+)(?:\(((?:[^\s&gt;\/]*|.*?))\))?/,
 717                 select: 'n = byPseudo(n, &quot;{1}&quot;, &quot;{2}&quot;);'
 718             },{
 719                 re: /^(?:([\[\{])(?:@)?([\w-]+)\s?(?:(=|.=)\s?['&quot;]?(.*?)[&quot;']?)?[\]\}])/,
 720                 select: 'n = byAttribute(n, &quot;{2}&quot;, &quot;{4}&quot;, &quot;{3}&quot;, &quot;{1}&quot;);'
 721             }, {
 722                 re: /^#([\w-]+)/,
 723                 select: 'n = byId(n, &quot;{1}&quot;);'
 724             },{
 725                 re: /^@([\w-]+)/,
 726                 select: 'return {firstChild:{nodeValue:attrValue(n, &quot;{1}&quot;)}};'
 727             }
 728         ],
 729
 730 <span id='Ext-DomQuery-property-operators'>        /**
 731 </span>         * Collection of operator comparison functions. The default operators are =, !=, ^=, $=, *=, %=, |= and ~=.
 732          * New operators can be added as long as the match the format &lt;i&gt;c&lt;/i&gt;= where &lt;i&gt;c&lt;/i&gt; is any character other than space, &amp;gt; &amp;lt;.
 733          */
 734         operators : {
 735             &quot;=&quot; : function(a, v){
 736                 return a == v;
 737             },
 738             &quot;!=&quot; : function(a, v){
 739                 return a != v;
 740             },
 741             &quot;^=&quot; : function(a, v){
 742                 return a &amp;&amp; a.substr(0, v.length) == v;
 743             },
 744             &quot;$=&quot; : function(a, v){
 745                 return a &amp;&amp; a.substr(a.length-v.length) == v;
 746             },
 747             &quot;*=&quot; : function(a, v){
 748                 return a &amp;&amp; a.indexOf(v) !== -1;
 749             },
 750             &quot;%=&quot; : function(a, v){
 751                 return (a % v) == 0;
 752             },
 753             &quot;|=&quot; : function(a, v){
 754                 return a &amp;&amp; (a == v || a.substr(0, v.length+1) == v+'-');
 755             },
 756             &quot;~=&quot; : function(a, v){
 757                 return a &amp;&amp; (' '+a+' ').indexOf(' '+v+' ') != -1;
 758             }
 759         },
 760
 761 <span id='Ext-DomQuery-property-pseudos'>        /**
 762 </span>Object hash of &quot;pseudo class&quot; filter functions which are used when filtering selections.
 763 Each function is passed two parameters:
 764
 765 - **c** : Array
 766     An Array of DOM elements to filter.
 767
 768 - **v** : String
 769     The argument (if any) supplied in the selector.
 770
 771 A filter function returns an Array of DOM elements which conform to the pseudo class.
 772 In addition to the provided pseudo classes listed above such as `first-child` and `nth-child`,
 773 developers may add additional, custom psuedo class filters to select elements according to application-specific requirements.
 774
 775 For example, to filter `a` elements to only return links to __external__ resources:
 776
 777     Ext.DomQuery.pseudos.external = function(c, v){
 778         var r = [], ri = -1;
 779         for(var i = 0, ci; ci = c[i]; i++){
 780             // Include in result set only if it's a link to an external resource
 781             if(ci.hostname != location.hostname){
 782                 r[++ri] = ci;
 783             }
 784         }
 785         return r;
 786     };
 787
 788 Then external links could be gathered with the following statement:
 789
 790     var externalLinks = Ext.select(&quot;a:external&quot;);
 791
 792         * @markdown
 793         */
 794         pseudos : {
 795             &quot;first-child&quot; : function(c){
 796                 var r = [], ri = -1, n;
 797                 for(var i = 0, ci; ci = n = c[i]; i++){
 798                     while((n = n.previousSibling) &amp;&amp; n.nodeType != 1);
 799                     if(!n){
 800                         r[++ri] = ci;
 801                     }
 802                 }
 803                 return r;
 804             },
 805
 806             &quot;last-child&quot; : function(c){
 807                 var r = [], ri = -1, n;
 808                 for(var i = 0, ci; ci = n = c[i]; i++){
 809                     while((n = n.nextSibling) &amp;&amp; n.nodeType != 1);
 810                     if(!n){
 811                         r[++ri] = ci;
 812                     }
 813                 }
 814                 return r;
 815             },
 816
 817             &quot;nth-child&quot; : function(c, a) {
 818                 var r = [], ri = -1,
 819                     m = nthRe.exec(a == &quot;even&quot; &amp;&amp; &quot;2n&quot; || a == &quot;odd&quot; &amp;&amp; &quot;2n+1&quot; || !nthRe2.test(a) &amp;&amp; &quot;n+&quot; + a || a),
 820                     f = (m[1] || 1) - 0, l = m[2] - 0;
 821                 for(var i = 0, n; n = c[i]; i++){
 822                     var pn = n.parentNode;
 823                     if (batch != pn._batch) {
 824                         var j = 0;
 825                         for(var cn = pn.firstChild; cn; cn = cn.nextSibling){
 826                             if(cn.nodeType == 1){
 827                                cn.nodeIndex = ++j;
 828                             }
 829                         }
 830                         pn._batch = batch;
 831                     }
 832                     if (f == 1) {
 833                         if (l == 0 || n.nodeIndex == l){
 834                             r[++ri] = n;
 835                         }
 836                     } else if ((n.nodeIndex + l) % f == 0){
 837                         r[++ri] = n;
 838                     }
 839                 }
 840
 841                 return r;
 842             },
 843
 844             &quot;only-child&quot; : function(c){
 845                 var r = [], ri = -1;;
 846                 for(var i = 0, ci; ci = c[i]; i++){
 847                     if(!prev(ci) &amp;&amp; !next(ci)){
 848                         r[++ri] = ci;
 849                     }
 850                 }
 851                 return r;
 852             },
 853
 854             &quot;empty&quot; : function(c){
 855                 var r = [], ri = -1;
 856                 for(var i = 0, ci; ci = c[i]; i++){
 857                     var cns = ci.childNodes, j = 0, cn, empty = true;
 858                     while(cn = cns[j]){
 859                         ++j;
 860                         if(cn.nodeType == 1 || cn.nodeType == 3){
 861                             empty = false;
 862                             break;
 863                         }
 864                     }
 865                     if(empty){
 866                         r[++ri] = ci;
 867                     }
 868                 }
 869                 return r;
 870             },
 871
 872             &quot;contains&quot; : function(c, v){
 873                 var r = [], ri = -1;
 874                 for(var i = 0, ci; ci = c[i]; i++){
 875                     if((ci.textContent||ci.innerText||'').indexOf(v) != -1){
 876                         r[++ri] = ci;
 877                     }
 878                 }
 879                 return r;
 880             },
 881
 882             &quot;nodeValue&quot; : function(c, v){
 883                 var r = [], ri = -1;
 884                 for(var i = 0, ci; ci = c[i]; i++){
 885                     if(ci.firstChild &amp;&amp; ci.firstChild.nodeValue == v){
 886                         r[++ri] = ci;
 887                     }
 888                 }
 889                 return r;
 890             },
 891
 892             &quot;checked&quot; : function(c){
 893                 var r = [], ri = -1;
 894                 for(var i = 0, ci; ci = c[i]; i++){
 895                     if(ci.checked == true){
 896                         r[++ri] = ci;
 897                     }
 898                 }
 899                 return r;
 900             },
 901
 902             &quot;not&quot; : function(c, ss){
 903                 return Ext.DomQuery.filter(c, ss, true);
 904             },
 905
 906             &quot;any&quot; : function(c, selectors){
 907                 var ss = selectors.split('|'),
 908                     r = [], ri = -1, s;
 909                 for(var i = 0, ci; ci = c[i]; i++){
 910                     for(var j = 0; s = ss[j]; j++){
 911                         if(Ext.DomQuery.is(ci, s)){
 912                             r[++ri] = ci;
 913                             break;
 914                         }
 915                     }
 916                 }
 917                 return r;
 918             },
 919
 920             &quot;odd&quot; : function(c){
 921                 return this[&quot;nth-child&quot;](c, &quot;odd&quot;);
 922             },
 923
 924             &quot;even&quot; : function(c){
 925                 return this[&quot;nth-child&quot;](c, &quot;even&quot;);
 926             },
 927
 928             &quot;nth&quot; : function(c, a){
 929                 return c[a-1] || [];
 930             },
 931
 932             &quot;first&quot; : function(c){
 933                 return c[0] || [];
 934             },
 935
 936             &quot;last&quot; : function(c){
 937                 return c[c.length-1] || [];
 938             },
 939
 940             &quot;has&quot; : function(c, ss){
 941                 var s = Ext.DomQuery.select,
 942                     r = [], ri = -1;
 943                 for(var i = 0, ci; ci = c[i]; i++){
 944                     if(s(ss, ci).length &gt; 0){
 945                         r[++ri] = ci;
 946                     }
 947                 }
 948                 return r;
 949             },
 950
 951             &quot;next&quot; : function(c, ss){
 952                 var is = Ext.DomQuery.is,
 953                     r = [], ri = -1;
 954                 for(var i = 0, ci; ci = c[i]; i++){
 955                     var n = next(ci);
 956                     if(n &amp;&amp; is(n, ss)){
 957                         r[++ri] = ci;
 958                     }
 959                 }
 960                 return r;
 961             },
 962
 963             &quot;prev&quot; : function(c, ss){
 964                 var is = Ext.DomQuery.is,
 965                     r = [], ri = -1;
 966                 for(var i = 0, ci; ci = c[i]; i++){
 967                     var n = prev(ci);
 968                     if(n &amp;&amp; is(n, ss)){
 969                         r[++ri] = ci;
 970                     }
 971                 }
 972                 return r;
 973             }
 974         }
 975     };
 976 }();
 977
 978 <span id='Ext-method-query'>/**
 979 </span> * Selects an array of DOM nodes by CSS/XPath selector. Shorthand of {@link Ext.DomQuery#select}
 980  * @param {String} path The selector/xpath query
 981  * @param {Node} root (optional) The start of the query (defaults to document).
 982  * @return {Array}
 983  * @member Ext
 984  * @method query
 985  */
 986 Ext.query = Ext.DomQuery.select;
 987 </pre>
 988 </body>
 989 </html>