getElementsByClassName 如今已是標配,但在需要支援老舊環境的專案裡,仍得自己寫一層相容封裝。本文示範一個同時兼顧原生 API 與手動走訪的 getClass 函式,並指出原始寫法中容易踩到的幾個坑。
function getClass(node, classname) {
// 有原生方法就直接用,速度最快
if (node.getElementsByClassName) {
return node.getElementsByClassName(classname);
}
// 否則手動走訪所有後代標籤
var elems = node.getElementsByTagName("*"),
defualt = [];
for (var i = 0; i < elems.length; i++) {
if (elems[i].className.indexOf(classname) != -1) {
defualt[defualt.length] = elems[i];
}
}
return defualt;
}
window.onload = function () {
var text = document.getElementById('text');
var cs = getClass(text, 'cs');
document.write(cs[0].innerHTML = 'cs');
};
原本寫成 node.getElementsByTagName(node),但這個方法要的是標籤名稱字串,不是節點。想取得全部後代,正確寫法是 "*"。
用 className.indexOf(classname) 來比對,只要子字串出現就算命中。也就是說找 'cs' 時,class="cshow"、class="scss" 都會被誤收進來。比較嚴謹的做法是切成陣列後精確比對:
var cn = (" " + elems[i].className + " ").indexOf(" " + classname + " ") > -1;或者用
elems[i].classList.contains(classname)(同樣需要相容處理)。三、回傳值型別不一致
原生
getElementsByClassName回傳的是即時集合(live HTMLCollection),手動版本回傳的則是普通陣列。兩者在「迴圈中修改 DOM」的情境下行為不同,封裝時最好統一,或直接轉成真陣列:return Array.prototype.slice.call(node.getElementsByClassName(classname));更簡潔的現代寫法
如果專案不必背負舊瀏覽器的包袱,
querySelectorAll幾乎可以取代所有查詢需求,而且支援標籤、class、id、屬性的任意組合:// 單一 class document.querySelectorAll('#text .cs'); // 多 class(同時含有 a 與 b) document.querySelectorAll('.a.b'); // 取第一個 document.querySelector('#text .cs');它同樣回傳靜態的 NodeList,若要當陣列操作,一樣用
Array.from()或slice.call轉型。小結
寫相容性封裝時,最容易出錯的往往不是主流程,而是那些「我以為一樣」的細節:參數型別、比對方式、回傳型別。把這三點釐清,你的工具函式庫就會比網路上抄來的大半程式碼更可靠。