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