萬盛學電腦網

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

JavaScript 透過 className 獲取元素通用函數實作 (getElementsByClassName Polyfill)

背景

早期瀏覽器 (IE8-) 不支援原生 document.getElementsByClassName()。本文實作一個相容所有瀏覽器的通用函數,掃描所有元素比對 className。

Polyfill 實作

/**
 * 依 className 取得元素集合 (相容 IE6+)
 * @param {String} className - 目標類別名稱
 * @param {Element} [root=document] - 搜尋根節點
 * @returns {Array} 符合的元素陣列
 */
function getElementsByClassName(className, root) {
    root = root || document;
    var elements = root.getElementsByTagName('*');
    var result = [];
    var pattern = new RegExp('(^|\\s)' + className + '(\\s|$)'); // 精確比對,避免 partial match
    
    for (var i = 0, len = elements.length; i < len; i++) {
        if (pattern.test(elements[i].className)) {
            result.push(elements[i]);
        }
    }
    return result;
}

// 現代瀏覽器直接用原生,舊瀏覽器用 polyfill
if (!document.getElementsByClassName) {
    document.getElementsByClassName = function(className) {
        return getElementsByClassName(className, this);
    };
    Element.prototype.getElementsByClassName = function(className) {
        return getElementsByClassName(className, this);
    };
}

使用範例

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <style>
        .highlight { color: red; font-weight: bold; }
        .box { border: 1px solid #ccc; padding: 10px; margin: 10px 0; }
    </style>
</head>
<body>
    <div class="box highlight">我有 highlight 類別</div>
    <div class="box">我沒有 highlight</div>
    <span class="highlight">行內元素也有 highlight</span>
    <div class="box highlight extra">多類別也能匹配</div>

    <script>
        // 使用 polyfill (或原生)
        var elements = getElementsByClassName('highlight');
        
        console.log('找到', elements.length, '個元素'); // 3
        
        elements.forEach(function(el) {
            el.style.backgroundColor = '#ffffcc'; // 標示找到的元素
        });
    </script>
</body>
</html>

進階優化版 (支援多類別、現代 API)

/**
 * 進階版:支援多類別 (空白分隔)、根節點限定、原生優先
 * @param {String} classNames - 類別名稱,空白分隔 (如 "foo bar")
 * @param {Element} [root=document]
 * @returns {Array}
 */
function queryElementsByClass(classNames, root) {
    root = root || document;
    
    // 現代瀏覽器直接用原生 (效能最佳)
    if (root.getElementsByClassName) {
        // 原生回傳 HTMLCollection,轉為陣列
        return Array.prototype.slice.call(root.getElementsByClassName(classNames));
    }
    
    // 舊瀏覽器降級處理
    var classes = classNames.trim().split(/\s+/);
    var selector = classes.map(function(c) { return '.' + c; }).join('');
    
    // 嘗試 querySelectorAll (IE8+ 支援 CSS2.1 選擇器)
    if (root.querySelectorAll) {
        return Array.prototype.slice.call(root.querySelectorAll(selector));
    }
    
    // 終極降級:遍歷所有元素
    var all = root.getElementsByTagName('*');
    var result = [];
    var regexCache = {};
    
    for (var i = 0, len = all.length; i < len; i++) {
        var el = all[i];
        var matched = true;
        for (var j = 0; j < classes.length; j++) {
            var cls = classes[j];
            // 快取正則
            if (!regexCache[cls]) {
                regexCache[cls] = new RegExp('(^|\\s)' + cls + '(\\s|$)');
            }
            if (!regexCache[cls].test(el.className)) {
                matched = false;
                break;
            }
        }
        if (matched) result.push(el);
    }
    return result;
}

效能比較與建議

方法支援瀏覽器效能建議
document.getElementsByClassName()IE9+、所有現代瀏覽器最快 (原生 C++ 實作)首選
document.querySelectorAll('.class')IE8+、所有現代瀏覽器快 (瀏覽器優化)次選,支援複雜選擇器
遍歷 getElementsByTagName('*') 比對 className所有 (含 IE6)慢 (JS 層遍歷)僅 IE8- 專案維護用

現代開發:直接用原生

// 取得陣列 (而非即時 HTMLCollection)
var elements = [...document.getElementsByClassName('myClass')];
// 或
var elements = Array.from(document.getElementsByClassName('myClass'));

// 範圍限定
var elements = [...container.getElementsByClassName('myClass')];

// 進階選擇器
var elements = document.querySelectorAll('.myClass .child[data-active]');

總結

理解 getElementsByClassName polyfill 實作有助於掌握 DOM 遍歷與字串比對技巧,但**現代專案 (2015+) 完全無需自行實作**,直接使用原生 API 或 querySelectorAll 即可。維護 IE8- 專案時,建議引入成熟的 polyfill 庫 (如 classlist.js、selectivizr) 而非自寫。

copyright © 萬盛學電腦網 all rights reserved