萬盛學電腦網

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

JavaScript 純原生實現 getElementsByClassName 相容方案

背景

現代瀏覽器(IE9+、所有主流瀏覽器)均原生支援 document.getElementsByClassName()。但在維護舊專案或需支援 IE8 以下環境時,仍需一個純 JS 相容實作。本文提供一個輕量、無依賴的 Polyfill 方案。

核心實作

/**
 * 相容性 getElementsByClassName 實作
 * @param {string} className - 目標類別名稱
 * @param {Element} [root=document] - 搜尋根節點(可選)
 * @returns {Array} 符合條件的元素陣列
 */
function getElementsByClassName(className, root) {
  root = root || document;
  var elements = root.getElementsByTagName('*');
  var result = [];
  var i, len;

  for (i = 0, len = elements.length; i < len; i++) {
    // 使用 classList(現代)或 className 字串匹配(舊版)
    if (elements[i].classList) {
      if (elements[i].classList.contains(className)) {
        result.push(elements[i]);
      }
    } else {
      // IE9 以下相容:檢查 className 字串
      var classes = ' ' + elements[i].className + ' ';
      if (classes.indexOf(' ' + className + ' ') > -1) {
        result.push(elements[i]);
      }
    }
  }
  return result;
}

使用範例

// 全域搜尋
var items = getElementsByClassName('item');
console.log(items.length);  // 找到的元素數量

// 限定範圍搜尋(效能更好)
var container = document.getElementById('container');
var itemsInContainer = getElementsByClassName('item', container);

進階優化版:支援多類別與原生優先

function getElementsByClassName(className, root) {
  root = root || document;

  // 1. 原生支援優先(最快)
  if (root.getElementsByClassName) {
    return Array.prototype.slice.call(root.getElementsByClassName(className));
  }

  // 2. querySelectorAll 相容(IE8+)
  if (root.querySelectorAll) {
    return Array.prototype.slice.call(root.querySelectorAll('.' + className));
  }

  // 3. 純 JS 回退(IE6-7)
  var elements = root.getElementsByTagName('*');
  var result = [];
  var regex = new RegExp('(^|\\s)' + className + '(\\s|$)');
  for (var i = 0, len = elements.length; i < len; i++) {
    if (regex.test(elements[i].className)) {
      result.push(elements[i]);
    }
  }
  return result;
}

效能建議

  • 優先縮小搜尋範圍:傳入 root 參數,避免全域遍歷
  • 原生 > querySelectorAll > 遍歷:效能遞減
  • 緩存結果:同一頁面多次查詢同類別,請緩存陣列

現代替代方案

若專案已引入現代工具鏈,建議直接使用:

  • document.getElementsByClassName('cls') —— 即時集合
  • document.querySelectorAll('.cls') —— 靜態 NodeList
  • element.classList.contains('cls') —— 單元素檢測

總結

理解原生 API 的相容實作,不僅能應付舊環境,更能深入掌握 DOM 遍歷機制。新專案請直接使用原生 API,舊專案可直接複製上方優化版 Polyfill 即可無痛相容。

copyright © 萬盛學電腦網 all rights reserved