現代標準 API(IE9+ 全支援)
1. document.getElementsByClassName(className)
- 返回**即時**
HTMLCollection(DOM 變更自動更新)。
- 僅支援單一 class 名稱(多 class 需傳入空格分隔字串:
"foo bar" 表示同時擁有 foo 和 bar)。
- 效能極佳(瀏覽器原生索引)。
const items = document.getElementsByClassName("item"); // 即時集合
// 轉陣列用:[...items] 或 Array.from(items)
2. document.querySelectorAll(selectors)
- 返回**靜態**
NodeList(快照,不隨 DOM 變動)。
- 支援完整 CSS 選擇器:
.class、.class1.class2、.parent .child、:not()、:nth-child() 等。
- 可鏈式調用:
element.querySelectorAll(".child") 限定範圍。
const items = document.querySelectorAll(".item.active"); // 同時有 item 和 active
const scoped = document.getElementById("list").querySelectorAll(".item");
IE8 及以下 Polyfill(若必須支援)
if (!document.getElementsByClassName) {
document.getElementsByClassName = function(className, root) {
root = root || document;
const results = [];
const elements = root.getElementsByTagName("*");
const classRegex = new RegExp("(^|\\s)" + className.replace(/\s+/g, "\\s+") + "(\\s|$)");
for (let i = 0; i < elements.length; i++) {
if (classRegex.test(elements[i].className)) {
results.push(elements[i]);
}
}
return results; // 返回陣列而非即時集合
};
}
// 同理補充 querySelectorAll(需 Sizzle 或 qsa-polyfill,體積較大,建議直接升級瀏覽器)
效能對比
| 方法 | 回傳類型 | 即時性 | 選擇器能力 | 相對查詢 |
getElementsByClassName | HTMLCollection | 即時 | 單/多 class (空格分隔) | 支援 (element.getElementsByClassName) |
querySelectorAll | NodeList | 靜態 | 完整 CSS 選擇器 | 支援 (element.querySelectorAll) |
最佳實踐建議
- **優先用
querySelectorAll**:功能最強、語意最清晰、回傳靜態列表避免迴圈中修改 DOM 導致索引錯亂。
- **高頻存取/大量元素**時考慮
getElementsByClassName(即時集合無建立快照開銷)。
- **單一元素**用
querySelector / getElementById。
- **避免**在迴圈中重複呼叫選擇器,先存變數。
實用工具函數
// 通用選取器,自動選擇最佳 API
function $(selector, context = document) {
if (selector.startsWith("#") && !selector.includes(" ") && !selector.includes(">")) {
return context.getElementById(selector.slice(1));
}
if (/^\.[\w-]+$/.test(selector)) { // 純 class 選擇器
return context.getElementsByClassName(selector.slice(1));
}
return context.querySelectorAll(selector);
}
// 使用
$(".item"); // HTMLCollection
$("#app .item"); // NodeList
$("#app"); // Element