document.getElementsByClassName(className) 已在所有現代瀏覽器 (IE9+) 支持,返回 即時 NodeList。
// 兼容寫入 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)
}
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 內部實現類似 querySelectorAll
$(".item") // 返回 jQuery 對象,已是數組-like
// 早期版本使用 Sizzle 引擎,現代版直接委派給 querySelectorAll
document.querySelectorAll() 或 element.querySelectorAll()。getElementsByClassName()**。Array.from()。