sync
[roojs1] / docs / symbols / Roo.DomQuery.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
3
4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
6         <head>
7                 <meta http-equiv="content-type" content="text/html; charset=undefined" />
8                 <meta name="generator" content="JsDoc Toolkit" />
9                 
10                 
11                 <title>JsDoc Reference - Roo.DomQuery</title>
12                 
13                 
14         <link rel="stylesheet" type="text/css" href="../../css/roojs.css" />            
15         <link rel="stylesheet" type="text/css" href="../default.css" />
16         
17         
18         <script type="text/javascript" src="../page.js">
19         
20         </script>
21          
22                 
23         </head>
24
25         <body onload="RooDocsPage.onload();">
26          
27         
28 <div class="body-wrap">
29
30     <!-- ============================== links to methods. ================================= --> 
31
32     <div class="top-tools">
33     <!--
34         <a class="inner-link" href="#Roo.DomQuery-props"><img src="resources/s.gif" class="item-icon icon-prop">Properties</a>
35         <a class="inner-link" href="#Roo.DomQuery-methods"><img src="resources/s.gif" class="item-icon icon-method">Methods</a>
36         <a class="inner-link" href="#Roo.DomQuery-events"><img src="resources/s.gif" class="item-icon icon-event">Events</a>
37         <a class="inner-link" href="#Roo.DomQuery-configs"><img src="resources/s.gif" class="item-icon icon-config">Config Options</a>
38         <a class="bookmark" href="NEED_TO_CREATE_DIRECT_LINK_HREF"><img src="resources/s.gif" class="item-icon icon-fav">Direct Link</a>
39         -->
40     </div>
41
42     
43 <!-- ============================== inheritance Block. ================================= -->    
44         
45 <!-- ============================== class title / details ============================ -->
46     
47     
48     <h1 class="classTitle">
49                                 
50                                 Class Roo.DomQuery
51                         </h1>
52                         
53     <table cellspacing="0" class="class-summary-table">
54         
55                 <tr><td class="label">Package:</td><td class="hd-info">Roo</td></tr>
56         
57         <tr><td class="label">Defined In:</td><td class="hd-info">
58                         
59                                         <a href="./src/Roo_DomQuery.js.html">Roo/DomQuery.js</a>.
60                         
61         </td></tr>
62         <tr><td class="label">Class:</td><td class="hd-info">DomQuery</td></tr>
63         
64         
65         
66         
67     </table>
68
69     
70 <!-- ============================== class summary ========================== -->                        
71     <div class="description">
72         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).<br/><p><br/>DomQuery supports most of the <a href="http://www.w3.org/TR/2005/WD-css3-selectors-20051215/">CSS3 selectors spec</a>, along with some custom selectors and basic XPath.</p><br/><br/><p><br/>All selectors, attribute filters and pseudos below can be combined infinitely in any order. For example "div.foo:nth-child(odd)[<b>foo</b>=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.<br/></p><br/><h4>Element Selectors:</h4><br/><ul class="list"><br/>    <li> <b>*</b> any element</li><br/>    <li> <b>E</b> an element with the tag E</li><br/>    <li> <b>E F</b> All descendent elements of E that have the tag F</li><br/>    <li> <b>E > F</b> or <b>E/F</b> all direct children elements of E that have the tag F</li><br/>    <li> <b>E + F</b> all elements with the tag F that are immediately preceded by an element with the tag E</li><br/>    <li> <b>E ~ F</b> all elements with the tag F that are preceded by a sibling element with the tag E</li><br/></ul><br/><h4>Attribute Selectors:</h4><br/><p>The use of @ and quotes are optional. For example, div[<b>foo</b>='bar'] is also a valid attribute selector.</p><br/><ul class="list"><br/>    <li> <b>E[foo]</b> has an attribute "foo"</li><br/>    <li> <b>E[foo=bar]</b> has an attribute "foo" that equals "bar"</li><br/>    <li> <b>E[foo^=bar]</b> has an attribute "foo" that starts with "bar"</li><br/>    <li> <b>E[foo$=bar]</b> has an attribute "foo" that ends with "bar"</li><br/>    <li> <b>E[foo*=bar]</b> has an attribute "foo" that contains the substring "bar"</li><br/>    <li> <b>E[foo%=2]</b> has an attribute "foo" that is evenly divisible by 2</li><br/>    <li> <b>E[foo!=bar]</b> has an attribute "foo" that does not equal "bar"</li><br/></ul><br/><h4>Pseudo Classes:</h4><br/><ul class="list"><br/>    <li> <b>E:first-child</b> E is the first child of its parent</li><br/>    <li> <b>E:last-child</b> E is the last child of its parent</li><br/>    <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><br/>    <li> <b>E:nth-child(odd)</b> E is an odd child of its parent</li><br/>    <li> <b>E:nth-child(even)</b> E is an even child of its parent</li><br/>    <li> <b>E:only-child</b> E is the only child of its parent</li><br/>    <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><br/>    <li> <b>E:first</b> the first E in the resultset</li><br/>    <li> <b>E:last</b> the last E in the resultset</li><br/>    <li> <b>E:nth(<i>n</i>)</b> the <i>n</i>th E in the resultset (1 based)</li><br/>    <li> <b>E:odd</b> shortcut for :nth-child(odd)</li><br/>    <li> <b>E:even</b> shortcut for :nth-child(even)</li><br/>    <li> <b>E:contains(foo)</b> E's innerHTML contains the substring "foo"</li><br/>    <li> <b>E:nodeValue(foo)</b> E contains a textNode with a nodeValue that equals "foo"</li><br/>    <li> <b>E:not(S)</b> an E element that does not match simple selector S</li><br/>    <li> <b>E:has(S)</b> an E element that has a descendent that matches simple selector S</li><br/>    <li> <b>E:next(S)</b> an E element whose next sibling matches simple selector S</li><br/>    <li> <b>E:prev(S)</b> an E element whose previous sibling matches simple selector S</li><br/></ul><br/><h4>CSS Value Selectors:</h4><br/><ul class="list"><br/>    <li> <b>E{display=none}</b> css value "display" that equals "none"</li><br/>    <li> <b>E{display^=none}</b> css value "display" that starts with "none"</li><br/>    <li> <b>E{display$=none}</b> css value "display" that ends with "none"</li><br/>    <li> <b>E{display*=none}</b> css value "display" that contains the substring "none"</li><br/>    <li> <b>E{display%=2}</b> css value "display" that is evenly divisible by 2</li><br/>    <li> <b>E{display!=none}</b> css value "display" that does not equal "none"</li><br/></ul>
73     </div>
74
75         
76 <!-- ============================== Class comment block... ========================== -->                                       
77
78 <div class="comments">
79         <b>Class Comments / Notes</B> =>  
80         <u onclick="parent.CommentDialog.showCommentId = 'Roo.DomQuery';">[Add Your comment/notes about this class]</u>
81         <br/>
82         <iframe frameborder="0"  id="comments-Roo" style="border: none;width:100%;" 
83                 src="/blog.php/GtkDjsComments/Roo.DomQuery.html"></iframe>
84 </div>
85         
86
87                 
88 <!-- ============================== config options ========================== -->                                               
89                  
90     
91     
92                 
93     <div class="hr"></div>
94     <a id="Roo.DomQuery-configs"></a>
95                 
96     
97     
98      <table cellspacing="0" class="member-table">
99       <caption class="Empty">Config Options - Has None</caption>
100      </table>
101     
102     
103      
104                 
105   
106   
107   
108   
109   
110   
111   
112   
113   <!-- ============================== public properties ==================== -->        
114   
115   
116   
117     <a id="Roo.DomQuery-props"></a>      
118     
119     
120
121     
122     
123      <table cellspacing="0" class="member-table">
124       <caption class="Empty">Public Properties - Has None</caption>
125      </table>
126     
127     
128      
129     
130   <!-- ============================== methods summary / details ======================== -->
131   
132   
133   <a id="Roo.DomQuery-methods"></a>
134         <!-- constructor?? -->
135         
136         <!-- static's first 
137         
138         
139         -->
140         
141         <!-- then dynamics first -->
142         
143   
144   
145     
146     
147     
148       <table cellspacing="0" class="member-table">
149       <caption>Public Methods</caption>
150         <tr>
151             <th class="sig-header" colspan="2">Method</th>            
152             <th class="msource-header">Defined By</th>
153
154         </tr>
155         
156         
157         
158          
159         
160         
161           
162           <tr class="method-row config-row-alt0 expandable notInherited">
163             <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
164            
165            
166             <td class="sig">
167                 <a id="Roo.DomQuery-method-compile"   name=".compile"></a>
168                 <div class="fixedFont">
169                         <span class="attributes">Roo.DomQuery.</span><b class="itemname">compile</b>
170                                 
171                                  (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>selector</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>type</i></B>) 
172                         
173                                 
174                                          : 
175                                         
176                                                 
177                                                 <a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a>
178                                         
179                                         
180                                         
181                                 
182                         
183                 </div>
184                 <div class="mdesc">
185                 
186                    <div class="short">Compiles a selector/xpath query into a reusable function.</div> 
187                  
188                  
189                  
190                     <div class="long">
191                         
192                                 Compiles a selector/xpath query into a reusable function. The returned function<br/>takes one parameter "root" (optional), which is the context node from where the query should start.
193                     
194                                 
195                         
196                         
197                         
198                         
199                                 <dl class="detailList">
200                                 <dt class="heading">Parameters:</dt>
201                                 
202                                         <dt>
203                                                 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span>  <b>selector</b>
204                                                 
205                                         </dt>
206                                         <dd>The selector/xpath query</dd>
207                                 
208                                         <dt>
209                                                 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span>  <b>type</b>
210                                                 
211                                         </dt>
212                                         <dd>(optional) Either "select" (the default) or "simple" for a simple selector match</dd>
213                                 
214                                 </dl>
215                         
216                         
217                         
218                         
219                         
220                                 <dl class="detailList">
221                                 <dt class="heading">Returns:</dt>
222                                 
223                                         <dd><span class="fixedFont"><a href="./Function.html#constructor" roo:cls="Function.html#constructor">Function</a></span>  </dd>
224                                 
225                                 </dl>
226                         
227                         
228                         
229
230                     
231                     
232                      
233                     </div>                    
234                 </div>
235
236             </td>
237             <td class="msource">
238                 
239                         Roo.DomQuery
240                 &nbsp;
241             </td>
242         </tr>
243         
244           
245           <tr class="method-row config-row-alt1 expandable notInherited">
246             <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
247            
248            
249             <td class="sig">
250                 <a id="Roo.DomQuery-method-filter"   name=".filter"></a>
251                 <div class="fixedFont">
252                         <span class="attributes">Roo.DomQuery.</span><b class="itemname">filter</b>
253                                 
254                                  (<a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a> <B><i>el</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>selector</i></B>, <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a> <B><i>nonMatches</i></B>) 
255                         
256                                 
257                                          : 
258                                         
259                                                 
260                                                 <a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a>
261                                         
262                                         
263                                         
264                                 
265                         
266                 </div>
267                 <div class="mdesc">
268                 
269                    <div class="short">Filters an array of elements to only include matches of a simple selector (e.g.</div> 
270                  
271                  
272                  
273                     <div class="long">
274                         
275                                 Filters an array of elements to only include matches of a simple selector (e.g. div.some-class or span:first-child)
276                     
277                                 
278                         
279                         
280                         
281                         
282                                 <dl class="detailList">
283                                 <dt class="heading">Parameters:</dt>
284                                 
285                                         <dt>
286                                                 <span class="fixedFont"><a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a></span>  <b>el</b>
287                                                 
288                                         </dt>
289                                         <dd>An array of elements to filter</dd>
290                                 
291                                         <dt>
292                                                 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span>  <b>selector</b>
293                                                 
294                                         </dt>
295                                         <dd>The simple selector to test</dd>
296                                 
297                                         <dt>
298                                                 <span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span>  <b>nonMatches</b>
299                                                 
300                                         </dt>
301                                         <dd>If true, it returns the elements that DON'T match<br/>the selector instead of the ones that match</dd>
302                                 
303                                 </dl>
304                         
305                         
306                         
307                         
308                         
309                                 <dl class="detailList">
310                                 <dt class="heading">Returns:</dt>
311                                 
312                                         <dd><span class="fixedFont"><a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a></span>  </dd>
313                                 
314                                 </dl>
315                         
316                         
317                         
318
319                     
320                     
321                      
322                     </div>                    
323                 </div>
324
325             </td>
326             <td class="msource">
327                 
328                         Roo.DomQuery
329                 &nbsp;
330             </td>
331         </tr>
332         
333           
334           <tr class="method-row config-row-alt0 expandable notInherited">
335             <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
336            
337            
338             <td class="sig">
339                 <a id="Roo.DomQuery-method-is"   name=".is"></a>
340                 <div class="fixedFont">
341                         <span class="attributes">Roo.DomQuery.</span><b class="itemname">is</b>
342                                 
343                                  (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement/Array <B><i>el</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>selector</i></B>) 
344                         
345                                 
346                                          : 
347                                         
348                                                 
349                                                 <a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a>
350                                         
351                                         
352                                         
353                                 
354                         
355                 </div>
356                 <div class="mdesc">
357                 
358                    <div class="short">Returns true if the passed element(s) match the passed simple selector (e.g.</div> 
359                  
360                  
361                  
362                     <div class="long">
363                         
364                                 Returns true if the passed element(s) match the passed simple selector (e.g. div.some-class or span:first-child)
365                     
366                                 
367                         
368                         
369                         
370                         
371                                 <dl class="detailList">
372                                 <dt class="heading">Parameters:</dt>
373                                 
374                                         <dt>
375                                                 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a>/HTMLElement/Array</span>  <b>el</b>
376                                                 
377                                         </dt>
378                                         <dd>An element id, element or array of elements</dd>
379                                 
380                                         <dt>
381                                                 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span>  <b>selector</b>
382                                                 
383                                         </dt>
384                                         <dd>The simple selector to test</dd>
385                                 
386                                 </dl>
387                         
388                         
389                         
390                         
391                         
392                                 <dl class="detailList">
393                                 <dt class="heading">Returns:</dt>
394                                 
395                                         <dd><span class="fixedFont"><a href="http://developer.mozilla.org/en/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean">Boolean</a></span>  </dd>
396                                 
397                                 </dl>
398                         
399                         
400                         
401
402                     
403                     
404                      
405                     </div>                    
406                 </div>
407
408             </td>
409             <td class="msource">
410                 
411                         Roo.DomQuery
412                 &nbsp;
413             </td>
414         </tr>
415         
416           
417           <tr class="method-row config-row-alt1 expandable notInherited">
418             <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
419            
420            
421             <td class="sig">
422                 <a id="Roo.DomQuery-method-select"   name=".select"></a>
423                 <div class="fixedFont">
424                         <span class="attributes">Roo.DomQuery.</span><b class="itemname">select</b>
425                                 
426                                  (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>selector</i></B>, Node <B><i>root</i></B>) 
427                         
428                                 
429                                          : 
430                                         
431                                                 
432                                                 <a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a>
433                                         
434                                         
435                                         
436                                 
437                         
438                 </div>
439                 <div class="mdesc">
440                 
441                    <div class="short">Selects a group of elements.</div> 
442                  
443                  
444                  
445                     <div class="long">
446                         
447                                 Selects a group of elements.
448                     
449                                 
450                         
451                         
452                         
453                         
454                                 <dl class="detailList">
455                                 <dt class="heading">Parameters:</dt>
456                                 
457                                         <dt>
458                                                 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span>  <b>selector</b>
459                                                 
460                                         </dt>
461                                         <dd>The selector/xpath query (can be a comma separated list of selectors)</dd>
462                                 
463                                         <dt>
464                                                 <span class="fixedFont">Node</span>  <b>root</b>
465                                                 
466                                         </dt>
467                                         <dd>(optional) The start of the query (defaults to document).</dd>
468                                 
469                                 </dl>
470                         
471                         
472                         
473                         
474                         
475                                 <dl class="detailList">
476                                 <dt class="heading">Returns:</dt>
477                                 
478                                         <dd><span class="fixedFont"><a href="./Array.html#constructor" roo:cls="Array.html#constructor">Array</a></span>  </dd>
479                                 
480                                 </dl>
481                         
482                         
483                         
484
485                     
486                     
487                      
488                     </div>                    
489                 </div>
490
491             </td>
492             <td class="msource">
493                 
494                         Roo.DomQuery
495                 &nbsp;
496             </td>
497         </tr>
498         
499           
500           <tr class="method-row config-row-alt0 expandable notInherited">
501             <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
502            
503            
504             <td class="sig">
505                 <a id="Roo.DomQuery-method-selectNode"   name=".selectNode"></a>
506                 <div class="fixedFont">
507                         <span class="attributes">Roo.DomQuery.</span><b class="itemname">selectNode</b>
508                                 
509                                  (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>selector</i></B>, Node <B><i>root</i></B>) 
510                         
511                                 
512                                          : 
513                                         
514                                                 
515                                                 Element
516                                         
517                                         
518                                         
519                                 
520                         
521                 </div>
522                 <div class="mdesc">
523                 
524                    <div class="short">Selects a single element.</div> 
525                  
526                  
527                  
528                     <div class="long">
529                         
530                                 Selects a single element.
531                     
532                                 
533                         
534                         
535                         
536                         
537                                 <dl class="detailList">
538                                 <dt class="heading">Parameters:</dt>
539                                 
540                                         <dt>
541                                                 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span>  <b>selector</b>
542                                                 
543                                         </dt>
544                                         <dd>The selector/xpath query</dd>
545                                 
546                                         <dt>
547                                                 <span class="fixedFont">Node</span>  <b>root</b>
548                                                 
549                                         </dt>
550                                         <dd>(optional) The start of the query (defaults to document).</dd>
551                                 
552                                 </dl>
553                         
554                         
555                         
556                         
557                         
558                                 <dl class="detailList">
559                                 <dt class="heading">Returns:</dt>
560                                 
561                                         <dd><span class="fixedFont">Element</span>  </dd>
562                                 
563                                 </dl>
564                         
565                         
566                         
567
568                     
569                     
570                      
571                     </div>                    
572                 </div>
573
574             </td>
575             <td class="msource">
576                 
577                         Roo.DomQuery
578                 &nbsp;
579             </td>
580         </tr>
581         
582           
583           <tr class="method-row config-row-alt1 expandable notInherited">
584             <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
585            
586            
587             <td class="sig">
588                 <a id="Roo.DomQuery-method-selectNumber"   name=".selectNumber"></a>
589                 <div class="fixedFont">
590                         <span class="attributes">Roo.DomQuery.</span><b class="itemname">selectNumber</b>
591                                 
592                                  (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>selector</i></B>, Node <B><i>root</i></B>, <a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a> <B><i>defaultValue</i></B>) 
593                         
594                                 
595                                          : 
596                                         
597                                                 
598                                                 <a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a>
599                                         
600                                         
601                                         
602                                 
603                         
604                 </div>
605                 <div class="mdesc">
606                 
607                    <div class="short">Selects the value of a node, parsing integers and floats.</div> 
608                  
609                  
610                  
611                     <div class="long">
612                         
613                                 Selects the value of a node, parsing integers and floats.
614                     
615                                 
616                         
617                         
618                         
619                         
620                                 <dl class="detailList">
621                                 <dt class="heading">Parameters:</dt>
622                                 
623                                         <dt>
624                                                 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span>  <b>selector</b>
625                                                 
626                                         </dt>
627                                         <dd>The selector/xpath query</dd>
628                                 
629                                         <dt>
630                                                 <span class="fixedFont">Node</span>  <b>root</b>
631                                                 
632                                         </dt>
633                                         <dd>(optional) The start of the query (defaults to document).</dd>
634                                 
635                                         <dt>
636                                                 <span class="fixedFont"><a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a></span>  <b>defaultValue</b>
637                                                 
638                                         </dt>
639                                         <dd></dd>
640                                 
641                                 </dl>
642                         
643                         
644                         
645                         
646                         
647                                 <dl class="detailList">
648                                 <dt class="heading">Returns:</dt>
649                                 
650                                         <dd><span class="fixedFont"><a href="./Number.html#constructor" roo:cls="Number.html#constructor">Number</a></span>  </dd>
651                                 
652                                 </dl>
653                         
654                         
655                         
656
657                     
658                     
659                      
660                     </div>                    
661                 </div>
662
663             </td>
664             <td class="msource">
665                 
666                         Roo.DomQuery
667                 &nbsp;
668             </td>
669         </tr>
670         
671           
672           <tr class="method-row config-row-alt0 expandable notInherited">
673             <td class="micon"><a class="exi" href="#expand">&nbsp;</a></td>
674            
675            
676             <td class="sig">
677                 <a id="Roo.DomQuery-method-selectValue"   name=".selectValue"></a>
678                 <div class="fixedFont">
679                         <span class="attributes">Roo.DomQuery.</span><b class="itemname">selectValue</b>
680                                 
681                                  (<a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>selector</i></B>, Node <B><i>root</i></B>, <a href="./String.html#constructor" roo:cls="String.html#constructor">String</a> <B><i>defaultValue</i></B>) 
682                         
683                                 
684                         
685                 </div>
686                 <div class="mdesc">
687                 
688                    <div class="short">Selects the value of a node, optionally replacing null with the defaultValue.</div> 
689                  
690                  
691                  
692                     <div class="long">
693                         
694                                 Selects the value of a node, optionally replacing null with the defaultValue.
695                     
696                                 
697                         
698                         
699                         
700                         
701                                 <dl class="detailList">
702                                 <dt class="heading">Parameters:</dt>
703                                 
704                                         <dt>
705                                                 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span>  <b>selector</b>
706                                                 
707                                         </dt>
708                                         <dd>The selector/xpath query</dd>
709                                 
710                                         <dt>
711                                                 <span class="fixedFont">Node</span>  <b>root</b>
712                                                 
713                                         </dt>
714                                         <dd>(optional) The start of the query (defaults to document).</dd>
715                                 
716                                         <dt>
717                                                 <span class="fixedFont"><a href="./String.html#constructor" roo:cls="String.html#constructor">String</a></span>  <b>defaultValue</b>
718                                                 
719                                         </dt>
720                                         <dd></dd>
721                                 
722                                 </dl>
723                         
724                         
725                         
726                         
727                         
728                         
729                         
730
731                     
732                     
733                      
734                     </div>                    
735                 </div>
736
737             </td>
738             <td class="msource">
739                 
740                         Roo.DomQuery
741                 &nbsp;
742             </td>
743         </tr>
744         
745                                                        
746     </table>
747
748   
749   <!-- ============================== events summary / details ======================== -->
750   
751   
752   <a id="Roo.DomQuery-events"></a>
753     
754   
755         
756    
757     
758      <table cellspacing="0" class="member-table">
759       <caption class="Empty">Events - Has None</caption>
760      </table>
761     
762     
763   
764     
765     
766   
767   
768   
769  
770 <!-- ============================== footer ================================= -->
771                 <div class="fineprint" style="clear:both">
772                         
773                         Documentation generated by <a href="http://www.akbkhome.com" target="_blankt">Introspection Doc Generator</a>  on Tue Jul 27 2010 11:05:06 GMT+0800 (HKT)
774                         Based on 
775                         <a href="http://www.jsdoctoolkit.org/" target="_blank">JsDoc Toolkit</a>  
776                 </div>
777         </body>
778 </html>