querySelector 與 querySelectorAll 是 W3C Selectors API 中定義的方法,用於依 CSS 選擇器語法定位文件元素。它們讓原生 JavaScript 能以更簡潔的方式取代部分常見 DOM 查詢。
querySelector 會回傳第一個符合條件的元素。querySelectorAll 則會回傳所有符合條件的節點集合,型別通常為 NodeList。兩者都接受 CSS 選擇器字串。
var first = document.querySelector('#test');
var all = document.querySelectorAll('.red');目前主流瀏覽器大多支援這兩個方法,包含較新的 IE 版本、Firefox、Chrome、Safari 與 Opera。因此在一般專案中,已可作為原生 DOM 查詢的重要工具。
querySelectorAll 回傳的 NodeList 通常不是即時的。這代表後續 DOM 變動不會自動反映到已取得的集合中。相對地,某些舊式 API 如 getElementsByClassName 可能回傳即時集合。理解這點,能避免動態操作時出現預期落差。
Element.querySelector 與 querySelectorAll 的搜尋範圍包含目前元素本身是否符合條件;jQuery 的 find 則通常只搜尋後代元素,不包含目前元素。這在選擇器以目前元素為根節點時,可能造成結果不同。
若只需要單一元素,可用 querySelector。若需要多個元素並進行大量操作,可搭配 forEach 或轉成陣列。若專案已使用 jQuery,也可依團隊習慣選擇,但理解原生 API 有助於減少依賴並提升效能掌控度。