教程:DomQuery基础

DomQuery基础
DomQuery的select函数有两个参数。第一个是选择符字符(selector string )而第二个是欲生成查询的标签ID(TAG ID)。本文中我准备使用函数“Ext.query”但读者须谨记它是“Ext.DomQuery.select()”的简写方式。

这是要入手的html:

<html>
 <head>
  <script type="text/javascript" src="../js/firebug/firebug.js"></script>
 </head>
 <body>
  <script type="text/javascript" src="../ext/ext-base.js"></script>
  <script type="text/javascript" src="../ext/ext-core.js"></script>
  <div id="bar"  class="foo">
   I'm a div ==> my id: bar, my class: foo
   <span class="bar">I'm a span within the div with a foo class</span>
   <a href="http://www.extjs.com" target="_blank">An ExtJs link</a>
  </div>
  <div id="foo" class="bar">
   my id: foo, my class: bar
   <p>I'm a P tag within the foo div</p>
   <span class="bar">I'm a span within the div with a bar class</span>
   <a href="#">An internal link</a>
  </div>
 </body>
</hmlt>

第一部分:元素选择符Selector
假设我想获取文档内所有的“span”标签:

// 这个查询会返回有两个元素的数组因为查询选中对整个文档的所有span标签。
Ext.query("span"); 
// 这个查询会返回有一个元素的数组因为查询顾及到了foo这个id。
Ext.query("span", "foo");

注意刚才怎么传入一个普通的字符串作为第一个参数。

按id获取标签,你需要加上“#”的前缀:

// 这个查询会返回包含我们foo div一个元素的数组!
Ext.query("#foo");

按class name获取标签,你需要加上“.”的前缀:
/*这个查询会返回有一个元素的数组,
包含与之前例子一样的div但是我们使用了class name来获取*/
Ext.query(".foo");

你也可以使用关键字“*”来获取所有的元素:
// 这会返回一个数组,包含文档的所有元素。
Ext.query("*");要获取子标签,我们只须在两个选择符之间插入一个空格: 

// 这会返回有一个元素的数组,内容为div标签下的p标签 
Ext.query("div p");
// 这会返回有两个元素的数组,内容为div标签下的span标签 
Ext.query("div span");

还有三个的元素选择符,待后续的教程会叙述。 ""

如果朋友你觉得这里说得太简单的话,你可以选择到DomQuery 文档看看,可能会有不少收获:)

第二部分:属性选择符Attributes selectors
这些选择符可让你得到基于一些属性值的元素。属性指的是html元素中的href, id 或 class。

// 我们检查出任何存在有class属性的元素。
// 这个查询会返回5个元素的数组。
Ext.query("*[class]"); // 结果: [body#ext-gen2.ext-gecko, div#bar.foo, span.bar, div#foo.bar, span.bar]现在我们针对特定的class属性进行搜索。 

// 这会得到class等于“bar”的所有元素
Ext.query("*[class=bar]");
 
// 这会得到class不等于“bar”的所有元素
Ext.query("*[class!=bar]");
 
// 这会得到class从“b”字头开始的所有元素
Ext.query("*[class^=b]");
 
//这会得到class由“r”结尾的所有元素
Ext.query("*[class$=r]");
 
//这会得到在class中抽出“a”字符的所有元素
Ext.query("*[class*=a]"); 

第三部分: CSS值元素选择符
这些选择符会匹配DOM元素的style属性。尝试在那份html中加上一些颜色:

<html>
 <head>
  <script type="text/javascript" src="../js/firebug/firebug.js"></script>
 </head>
 <body>
  <script type="text/javascript" src="../ext/ext-base.js"></script>
  <script type="text/javascript" src="../ext/ext-core.js"></script>
  <div id="bar" class="foo" style="color:red;">
   我是一个div ==> 我的id是: bar, 我的class: foo
   <span class="bar" style="color:pink;">I'm a span within the div with a foo class</span>
   <a href="http://www.extjs.com" target="_blank" style="color:yellow;">An ExtJs link with a blank target!</a>
  </div>
  <div id="foo" class="bar" style="color:fushia;">
   my id: foo, my class: bar
   <p>I'm a P tag within the foo div</p>
   <span class="bar" style="color:brown;">I'm a span within the div with a bar class</span>
   <a href="#" style="color:green;">An internal link</a>
  </div>
 </body>
</html>

基于这个CSS的颜色值我们不会作任何查询,但可以是其它的内容。它的格式规定是这样的:

元素{属性 操作符 值}

注意我在这里是怎么插入一个不同的括号。

所以,操作符(operators)和属性选择符(attribute selectors)是一样的。

// 获取所以红色的元素
Ext.query("*{color=red}"); // [div#bar.foo]
 
// 获取所有粉红颜色的并且是有红色子元素的元素
Ext.query("*{color=red} *{color=pink}"); // [span.bar]
 
// 获取所有不是红色文字的元素
Ext.query("*{color!=red}"); // [html, head, script firebug.js, link, body#ext-gen2.ext-gecko, script ext-base.js, script ext-core.js, span.bar, a www.extjs.com, div#foo.bar, p, span.bar, a test.html#]
 
// 获取所有颜色属性是从“yel”开始的元素
Ext.query("*{color^=yel}"); // [a www.extjs.com]
 
// 获取所有颜色属性是以“ow”结束的元素
Ext.query("*{color$=ow}"); // [a www.extjs.com]
 
// 获取所有颜色属性包含“ow”字符的元素
Ext.query("*{color*=ow}"); // [a www.extjs.com, span.bar] 

第四部分:伪类选择符Pseudo Classes selectors
仍然是刚才的网页,但是有所不同的只是新加上了一个UL元素、一个TABLE元素和一个FORM元素,以便我们可以使用不同的伪类选择符,来获取节点。
<html>
 <head>
  <script type="text/javascript" src="../js/firebug/firebug.js"></script>
 </head>
 <body>
  <script type="text/javascript" src="../ext/ext-base.js"></script>
  <script type="text/javascript" src="../ext/ext-core.js"></script>
  <div id="bar" class="foo" style="color:red; border: 2px dotted red; margin:5px; padding:5px;">
   我是一个div ==> 我的id是bar,我的class是foo
   <span class="bar" style="color:pink;">这里是span元素,外层的div元素有foo的class属性</span>
   <a href="http://www.extjs.com" target="_blank" style="color:yellow;">设置blank=target的ExtJS链接</a>
  </div>
  <div id="foo" class="bar" style="color:fushia; border: 2px dotted black; margin:5px; padding:5px;">
   这里的id是:foo,这里的class是bar
   <p>“foo” div包围下的p元素。</p>
   <span class="bar" style="color:brown;">这里是一个span元素,外层是div包围着,span还有一个bar的class属性。</span>
   <a href="#" style="color:green;">内置链接</a>
  </div>
  <div style="border:2px dotted pink; margin:5px; padding:5px;">
   <ul>
    <li>条目 #1</li>
    <li>条目 #2</li>
    <li>条目 #3</li>
    <li>条目 #4 带有<a href="#">链接</a></li>
   </ul>
   <table style="border:1px dotted black;">
    <tr style="color:pink">
     <td>第一行,第一列</td>
     <td>第一行,第二列</td>
    </tr>
    <tr style="color:brown">
        <td colspan="2">第二行,已合并单元格!</td>
    </tr>
    <tr>
     <td>第三行,第一列</td>
     <td>第三行,第二列</td>
    </tr> 
   </table>
  </div>
  <div style="border:2px dotted red; margin:5px; padding:5px;">
   <form>
    <input id="chked" type="checkbox" checked/><label for="chked">已点击</label>
    <br /><br />
    <input id="notChked" type="checkbox" /><label for="notChked">not me brotha!</label>
   </form>
  </div>
 </body>
</html>

然后我们这样测试:

/*
 SPAN元素为其父元素的第一个子元素
*/
Ext.query("span:first-child"); // [span.bar]
 
/*
 A元素为其父元素的最后一个子元素
*/
Ext.query("a:last-child") // [a www.extjs.com, a test.html#]
 
/*
 SPAN元素为其父元素的第2个子元素(由1开始的个数)
*/
Ext.query("span:nth-child(2)") // [span.bar]
 
/*
 TR元素为其父元素的奇数个数的子元素
*/
Ext.query("tr:nth-child(odd)") // [tr, tr]
 
/*
 LI元素为其父元素的奇数个数的子元素
*/
Ext.query("li:nth-child(even)") // [li, li]
 
/*
 返回A元素,A元素为其父元素的唯一子元素
*/
 
Ext.query("a:only-child") // [a test.html#]
 
/*
 返回所有选中的(checked)的INPUT元素
*/
Ext.query("input:checked") // [input#chked on]
 
/*
 返回第一个的TR元素
*/
Ext.query("tr:first") // [tr]
 
/*
 返回最后一个的INPUT元素
*/
Ext.query("input:last") // [input#notChked on]
 
/*
 返回第二个的TD元素
*/
Ext.query("td:nth(2)") // [td]
 
/*
 返回每一个包含“within”字符串的DIV
*/
Ext.query("div:contains(within)") // [div#bar.foo, div#foo.bar]
 
/*
 返回没有包含FORM子元素以外的那些DIV
*/
Ext.query("div:not(form)") [div#bar.foo, div#foo.bar, div]
 
/*
 返回包含有A元素的那些DIV集合
*/
Ext.query("div:has(a)") // [div#bar.foo, div#foo.bar, div]
 
/* 
返回接着会继续有TD的那些TD集合。
尤其一个地方是,如果使用了colspan属性的TD便会忽略
*/
Ext.query("td:next(td)") // [td, td]
 
/*
 返回居前于INPUT元素的那些LABEL元素集合
*/
Ext.query("label:prev(input)") //[label, label] 

总结
API依然最重要的资讯来源。本篇教程做的仅仅是拿一张现实中的网页示范了一些结果。

如读者已了解过API的DomQuery内容,可跳过本文,直接阅读 DomQuery advanced tutorial!

Author: Bernard Chhun (译者:Frank Cheung)

Retrieved from "http://extjs.com/learn/Tutorial:DomQuery_Basics%28Chinese%29"