早期瀏覽器 (IE8-) 不支援原生 document.getElementsByClassName()。本文實作一個相容所有瀏覽器的通用函數,掃描所有元素比對 className。
/**
* 依 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>
/**
* 進階版:支援多類別 (空白分隔)、根節點限定、原生優先
* @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) 而非自寫。