前面寫範例時我把參數都省略了,這次先把函式原型攤開來看。
Ext.get( Mixed el ) : Element
el : 節點 id、DOM Node,或既有的 Element
回傳 : Element 物件
Ext.query( String path, [Node root] ) : Array
path : 選擇器 / xpath 查詢字串
root : 查詢起點,可省略,預設為 document
回傳 : DOM Node 的陣列
Ext.query() 回傳的是 DOM Node 陣列,而 Ext.get() 的參數正好接受 DOM Node。所以最靈活的取法就是:先用 query 撈到節點,再交給 get 包裝成 Element。
var x = Ext.query(QueryStr); // 這裡 x 是陣列,需自行取出要的那一個
var y = Ext.get(x); // 包裝成 Element 後就能用 Ext 的方法
之所以不寫成內嵌形式,就是因為 query 的結果是集合,得先決定要哪一筆。至於拿到 Element 之後能做什麼,Ext JS 官方文件中 Ext.Element 那一章寫得很完整,這裡不複述。
格式與 jQuery 的 selector 幾乎一致。以下用這段 HTML 說明:
<html>
<body>
<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="https://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>
<div name="BlueLotus7">BlueLotus7@126.com</div>
</body>
</html>
Ext.query("span"); // 2 個元素,選中文書中所有 span
Ext.query("span", "foo"); // 1 個元素,限定在 id 為 foo 的範圍內
Ext.query("div p"); // 1 個元素,div 下的 p
Ext.query("div span"); // 2 個元素,div 下的 span
Ext.query("#foo"); // 1 個元素,即 id 為 foo 的 div
// 或者直接 Ext.get("foo");
Ext.query(".foo"); // 1 個元素
Ext.query("*[class]"); // 5 個元素:所有帶 class 屬性的節點
這組語法可以同時處理 id、name、class、style 等屬性,威力最強。
Ext.query("*[class=bar]"); // class 等於 bar
Ext.query("*[class!=bar]"); // class 不等於 bar
Ext.query("*[class^=b]"); // class 以 b 開頭
Ext.query("*[class$=r]"); // class 以 r 結尾
Ext.query("*[class*=a]"); // class 中含有 a
Ext.query("*[name=BlueLotus7]");// name 等於 BlueLotus7
換一段帶行內 style 的 HTML 來看屬性比對的實際效果:
<div id="bar" class="foo" style="color:red;">
<span class="bar" style="color:pink;">...</span>
<a href="https://www.extjs.com" target="_blank" style="color:yellow;">...</a>
</div>
<div id="foo" class="bar" style="color:fushia;">
<p>...</p>
<span class="bar" style="color:brown;">...</span>
<a href="#" style="color:green;">...</a>
</div>
Ext.query("*{color=red}"); // [div#bar.foo]
Ext.query("*{color=red} *{color=pink}"); // [span.bar] 紅色且含粉紅子元素
Ext.query("*{color!=red}"); // 所有非紅色文字的節點
Ext.query("*{color^=yel}"); // 顏色以 yel 開頭 → [a www.extjs.com]
Ext.query("*{color$=ow}"); // 顏色以 ow 結尾 → [a www.extjs.com]
Ext.query("*{color*=ow}"); // 顏色含 ow → [a www.extjs.com, span.bar]
Ext.query("span:first-child"); // 作為父元素第一個孩子的 span
Ext.query("a:last-child"); // 作為最後一個孩子的 a
Ext.query("span:nth-child(2)"); // 第 2 個孩子且為 span(序數從 1 起)
Ext.query("tr:nth-child(odd)"); // 奇數列的 tr
Ext.query("li:nth-child(even)"); // 偶數列的 li
Ext.query("a:only-child"); // 父元素中的獨子 a
Ext.query("input:checked"); // 所有勾選的 input
Ext.query("tr:first"); // 第一個 tr
Ext.query("input:last"); // 最後一個 input
Ext.query("td:nth(2)"); // 第 2 個 td
Ext.query("div:contains(within)"); // 內容含 within 字串的 div
Ext.query("div:not(form)"); // 排除 form 之後的 div
Ext.query("div:has(a)"); // 內含 a 的 div
Ext.query("td:next(td)"); // 緊接著還有 td 的那些 td(有 colspan 者會被忽略)
Ext.query("label:prev(input)"); // 前面緊鄰 input 的 label
Ext.query() 負責「找」,Ext.get() 負責「用」。日常若已知 id,直接 Ext.get() 最快;需要複雜條件時,交給 query 篩選,再把結果丟進 get 取得完整的方法鏈。這個組合讓 Ext JS 的元素取得方式彈性接近 jQuery,卻又保有 Element 包裝帶來的一致性。