在傳統 JavaScript 開發裡,「怎麼找到那個元素」往往是第一個讓人頭痛的事。原生提供的查詢方法很有限,只能靠標籤名、name、id 幾種方式,精度不夠時還得寫上一長串看起來很吃力的正則,或者直接引入一個函式庫。
事實上,各家瀏覽器早已普遍支援 querySelector 與 querySelectorAll,連微軟都推出 IE 8 作為支援代表。有了它們,你可以像寫 CSS 選擇器那樣精準地抓到需要的節點,學習成本幾乎為零。
先從最簡單的例子開始。假設有一個 id 為 test 的 div,傳統寫法是:
document.getElementById("test");
換成新方法:
document.querySelector("#test");
document.querySelectorAll("#test")[0];
小示範:
我是 id 為 test 的 div
看起來差別不大?那是因為例子太簡單。一旦結構稍微複雜,傳統做法立刻變得囉嗦,而這兩個方法的優勢也就浮現了。例如要取出「class 為 test 的 div 底下、第一個 p 子元素」,用文字描述都很拗口,用選擇器寫卻一目了然:
document.querySelector("div.test>p:first-child");
document.querySelectorAll("div.test>p:first-child")[0];
小示範:
我是層裡的 p 標籤
所以參數規則很單純:寫法和 CSS 選擇器完全一致。兩者的差別在於回傳結果——querySelector 只回傳第一個符合的元素,找不到時回傳 null;querySelectorAll 回傳一個包含所有符合元素的集合,找不到時回傳空集合。
下面這個例子用 querySelectorAll 把所有 class 為 emphasis 的元素加粗:
var emphasisText = document.querySelectorAll(".emphasis");
for( var i = 0 , j = emphasisText.length ; i < j ; i++ ){
emphasisText[i].style.fontWeight = "bold";
}
這是純原生實作,速度比 jQuery 更快;缺點是不支援 IE 6、7。
querySelector:return the first matching Element node within the node's subtrees. If there is no such node, the method must return null.(回傳該元素子樹中符合 selector 的第一個節點,若無符合則回傳 null)
querySelectorAll:return a NodeList containing all of the matching Element nodes within the node's subtrees, in document order. If there are no such nodes, the method must return an empty NodeList.(以文件順序回傳子樹中所有符合的節點集合;若無符合則回傳空集合)
當 baseElement 是 document 時,各家瀏覽器實作基本一致,沒什麼問題。但當 baseElement 換成一個普通的 DOM 節點時,情況就有點微妙了:
<div class="test" id="testId">
<p><span>Test</span></p>
</div>
<script type="text/javascript">
var testElement = document.getElementById('testId');
var element = testElement.querySelector('.test span');
var elementList = document.querySelectorAll('.test span');
console.log(element); // <span>Test</span>
console.log(elementList); // 1
</script>
依 W3C 的定義,這裡應該要回傳 element: null、elementList: [] 才對,因為以 testElement 為範圍時,它的子樹裡並沒有符合條件的節點。但瀏覽器似乎忽略了 baseElement,只認 selector,行為上幾乎等同於直接對 document 操作。這與我們的預期不符,只能期待後續版本把口徑統一起來。
聰明的開發者不會等。Andrew Dupont 提出一個繞道解法:在 selector 前面加上 baseElement 的 id,人為限制比對範圍。這個技巧後來被各大框架廣泛採用。
jQuery 的實作片段(1.6 版):
var oldContext = context, old = context.getAttribute( "id" ), nid = old || id,
try {
if ( !relativeHierarchySelector || hasParent ) {
return makeArray( context.querySelectorAll( "[id='" + nid + "'] " + query ), extra );
}
} catch (pseudoError) {}
finally {
if ( !old ) {
oldContext.removeAttribute( "id" );
}
}
只看關鍵部分:如果 baseElement 本來沒有 id,就先幫它塞一個(原始碼中為 __sizzle__),呼叫時把這個 id 選擇器拼在 query 前面以限定範圍;用完之後,因為這個 id 並不屬於該元素,還得再移除掉。
Mootools 的做法幾乎相同:
var currentId = _context.getAttribute( 'id' ), slickid = 'slickid__' ; _context.setAttribute( 'id' , slickid); _expression = '#' + slickid + ' ' + _expression; context = _context.parentNode;
只是把暫時的 id 換成 slickid__,思路完全一致。
相容性方面:Firefox 3.5+、IE 8+、Chrome 1+、Opera 10+、Safari 3.2+ 均可使用;IE 8 的限制是不支援以 object 作為 baseElement。