querySelector 與 querySelectorAll 定義於 W3C Selectors API 規範,作用是依 CSS 選擇器語法定位文件中的元素。目前主流瀏覽器(IE8 及以上、Firefox、Chrome、Safari、Opera)均已支援,因此它們已成為日常 DOM 查詢的首選。
module dom {
[Supplemental, NoInterfaceObject] interface NodeSelector {
Element querySelector(in DOMString selectors);
NodeList querySelectorAll(in DOMString selectors);
};
Document implements NodeSelector;
DocumentFragment implements NodeSelector;
Element implements NodeSelector;
};
可以看到 Document、DocumentFragment、Element 都實作了 NodeSelector 介面,也就是這三類物件都具備這兩個方法。參數必須是符合 CSS selector 語法的字串。
兩者的差異只有一點:querySelector 回傳單一物件(第一個符合條件的元素),querySelectorAll 回傳集合(NodeList)。
取得 id 屬性為 test 的元素:
document.getElementById("test");
document.querySelector("#test");
document.querySelectorAll("#test")[0];
取得 class 屬性為 red 的元素:
document.getElementsByClassName('red');
document.querySelector('.red');
document.querySelectorAll('.red');
這一點最容易忽略。querySelectorAll 回傳的 NodeList 是靜態快照(no-live),不會隨 DOM 變化而更新;而 getElementsByClassName、getElementsByTagName、childNodes 等回傳的是即時集合(live)。
<div id="container"> <div></div> <div></div> </div>
// 先選取 id 為 container 的元素
var container = document.getElementById('container');
console.log(container.childNodes.length); // 2
// 動態加入一個子元素
container.appendChild(document.createElement('div'));
// container 這個集合會自動更新
console.log(container.childNodes.length); // 3
上例中 childNodes 屬於即時集合,新增節點後數量自動從 2 變為 3(這裡不計入某些瀏覽器會把空白節點也計入).
實務影響:如果你先用 querySelectorAll 取到一份 NodeList,接著迴圈中又對 DOM 做增刪,那份 NodeList 不會跟著改變,往往需要重新查詢。反之,在迴圈中遍歷即時集合並同時修改 DOM,容易造成無窮迴圈——兩種行為都要清楚。
<div id="test1">
<a href="https://www.jb51.net/"></a>
</div>
<p id="bar">111</p>
<script>
var d1 = document.getElementById('test1');
var obj1 = d1.querySelector('div a');
var obj2 = d1.querySelectorAll('div a');
var obj3 = $(d1).find('div a');
console.log(obj1); // <a href="https://www.jb51.net/"></a>
console.log(obj2.length); // 1
console.log(obj3); // 空集合
</script>
差別在於搜尋範圍:
querySelectorAll:在文件內找出所有符合選擇器描述的節點,包含 Element 本身。因此 div a 中的 div 可以匹配到 d1 自己,再往下找到 a。jQuery(element).find(selector):同樣搜尋後代,但不包含 Element 本身,因此 div a 匹配不到任何結果。這個差異在遷移既有 jQuery 程式碼到原生 API 時特別容易造成 bug,值得留意。
getElementById 依然是效能最好的選擇。querySelector/querySelectorAll。