querySelectorAll() 接受與 querySelector() 相同的兩個參數(CSS 查詢與可選的命名空間解析器),但回傳的是所有符合的節點,而非單一元素。該方法回傳一個名為 StaticNodeList 的新型別實例。
顧名思義,StaticNodeList 具備 NodeList 的所有屬性與方法,但其底層實作是元素集合的一個快照,而非每次都針對文件動態查詢,因而消除了大部分使用 NodeList 帶來的效能問題。
只要呼叫 querySelectorAll() 就會回傳一個 StaticNodeList 物件,無論符合的元素有多少個;若無符合項,則 StaticNodeList 為空。它與 querySelector() 一樣存在於 Document 與 Element 類型上。以下為一些例子:
//獲取中的所有圖像(和getElementsByTagName("img")一樣) var images = document.getElementById("myDiv").querySelectorAll("img"); //獲取所有包含"selected"類的元素 var selected = document.querySelectorAll(".selected"); //獲取所有元素中的元素 var strongs = document.querySelectorAll("p strong");
回傳的 StaticNodeList 物件能以與 NodeList 相同的方式迭代,使用 item() 或方括號標記檢索單個元素,如下:
for (var i = 0, len = strongs.length; i < len; i++) { var strong = strongs[i]; //或strongs.item(i) strong.className = "important"; }也可在 querySelectorAll() 中使用命名空間解析器:
var svgImages = document.querySelectorAll("svg|svg", function (prefix) { switch (prefix) { case "svg": return "https://www.w3.org/2000/svg"; //此處其它代碼 } });這段例子檢索了文件中所有使用 <svg:svg> 定義的 SVG 圖像。