萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

原生 JavaScript 依 class 選取元素:getElementsByClassName 與 querySelectorAll

現代標準 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,體積較大,建議直接升級瀏覽器)

效能對比

方法回傳類型即時性選擇器能力相對查詢
getElementsByClassNameHTMLCollection即時單/多 class (空格分隔)支援 (element.getElementsByClassName)
querySelectorAllNodeList靜態完整 CSS 選擇器支援 (element.querySelectorAll)

最佳實踐建議

  1. **優先用 querySelectorAll**:功能最強、語意最清晰、回傳靜態列表避免迴圈中修改 DOM 導致索引錯亂。
  2. **高頻存取/大量元素**時考慮 getElementsByClassName(即時集合無建立快照開銷)。
  3. **單一元素**用 querySelector / getElementById。
  4. **避免**在迴圈中重複呼叫選擇器,先存變數。

實用工具函數

// 通用選取器,自動選擇最佳 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
copyright © 萬盛學電腦網 all rights reserved