現代瀏覽器(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 參數,避免全域遍歷若專案已引入現代工具鏈,建議直接使用:
document.getElementsByClassName('cls') —— 即時集合document.querySelectorAll('.cls') —— 靜態 NodeListelement.classList.contains('cls') —— 單元素檢測理解原生 API 的相容實作,不僅能應付舊環境,更能深入掌握 DOM 遍歷機制。新專案請直接使用原生 API,舊專案可直接複製上方優化版 Polyfill 即可無痛相容。