萬盛學電腦網

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

跨瀏覽器獲取指定 class 元素:getElementsByClassName Polyfill 從 ES5 到現代原生

原生 API 現狀

document.getElementsByClassName(className) 已在所有現代瀏覽器 (IE9+) 支持,返回 即時 NodeList。

Polyfill 實現 (兼容 IE6-8)

// 兼容寫入 document 或 Element 原型
if (!document.getElementsByClassName) {
    document.getElementsByClassName = function(className) {
        return getElementsByClassNamePolyfill(this, className);
    };
    Element.prototype.getElementsByClassName = function(className) {
        return getElementsByClassNamePolyfill(this, className);
    };
}

function getElementsByClassName(root, className) {
    // 1. 原生可用直接委派
    if (root.getElementsByClassName) {
        return root.getElementsByClassName(className);
    }
    // 2. 回退:遍歷所有元素匹配 className
    var results = [];
    var elems = root.getElementsByTagName("*");
    var classes = className.split(/\s+/); // 支持多類名 (任一匹配即可)
    for (var i = 0, len = elems.length; i < len; i++) {
        var el = elems[i];
        var elClasses = (el.className || '').split(/\s+/);
        var match = classes.every(function(c) { return elClasses.indexOf(c) > -1; });
        if (match) results.push(el);
    }
    return results; // 返回靜態數組 (非即時 NodeList)
}

Robert Nyman 終極版優化 (支持 XPath 加速)

var getElementsByClassName = function(className, tag, elm) {
    if (document.getElementsByClassName) {
        return (elm || document).getElementsByClassName(className);
    }
    // XPath 加速 (Firefox 3+, Safari, Chrome, Opera 支持)
    if (document.evaluate) {
        var xpath = ".//" + (tag || "*") + "[contains(concat(' ', @class, ' '), ' " + className + " ')]";
        var result = document.evaluate(xpath, (elm || document), null, 0, null);
        var nodes = [], node;
        while (node = result.iterateNext()) nodes.push(node);
        return nodes;
    }
    // 回退遍歷 (同上)
    // ...
};

現代最佳實踐:querySelectorAll

// 獲取所有 .item 元素 (靜態 NodeList,非即時)
var items = document.querySelectorAll(".item");
// 或限定範圍
var items = container.querySelectorAll(".item");

// 轉真數組
var itemsArr = Array.from(items); // 或 [...items]
itemsArr.forEach(el => el.classList.add("active"));

優勢:支持完整 CSS 選擇器 (後代、子代、屬性、偽類)、返回靜態列表避免 DOM 變更導致索引錯亂、性能優於 getElementsByClassName (瀏覽器內部優化)。

jQuery 時代的寫法 (參考)

// jQuery 內部實現類似 querySelectorAll
$(".item") // 返回 jQuery 對象,已是數組-like
// 早期版本使用 Sizzle 引擎,現代版直接委派給 querySelectorAll

總結建議

  1. 現代項目:直接用 document.querySelectorAll() 或 element.querySelectorAll()。
  2. 需即時列表 (極少見):**getElementsByClassName()**。
  3. 需兼容 IE8-:引入上述 Polyfill 或使用 selector-native。
  4. 避免在循環中操作即時 NodeList 導致索引跳過,先轉數組 Array.from()。
copyright © 萬盛學電腦網 all rights reserved