querySelector() 方法接受一個 CSS 查詢並回傳符合模式的第一個後代元素,若無符合元素則回傳 null。看下面的例子:
//獲取body元素
var body = document.querySelector("body");
//獲取ID為myDiv的元素
var myDiv = document.querySelector("#myDiv");
//獲取第一個包含類selected的元素
var selected = document.querySelector(".selected");
//獲取第一個包含類button的圖像元素
var img = document.body.querySelector("img.button");
當 querySelector() 應用於 Document 類型時,它會嘗試從文件元素開始匹配;若應用於 Element 類型,則只從該元素的後代節點中尋找符合項。CSS 查詢可依需要複雜化或簡單化,若查詢有語法錯誤或使用不支援的選擇器,querySelector() 會拋出錯誤。
querySelector() 還接受可選的第二個參數——命名空間解析器,它是一個接受命名空間前綴並回傳相關 URI 的函式,類似:
var nsresolver = function (prefix) {
switch (prefix) {
case "w3cmm":
return "https://www.w3cmm.com";
//此處其它代碼
}
};
命名空間解析器對於在嵌入了 SVG 或 MathML 等其他語言的 XHTML 文件(以及 XML 文件)中執行查詢非常有用。CSS 查詢中的命名空間使用一個管線來指定,如下:
var svgImage = document.querySelector("svg|svg", function (prefix) {
switch (prefix) {
case "svg":
return "https://www.w3.org/2000/svg";
}
});
這個例子透過在文件中查找定義為 <svg:svg> 的元素,回傳第一個 SVG 圖像。當查詢中遇到 svg 命名空間前綴時,便呼叫命名空間解析器函式來確定 URI;若沒有解析器,則會拋出錯誤,因為查詢引擎無法辨識 svg 前綴。