幾乎每個剛接觸 JavaScript 的人都會抱怨同一件事:為什麼沒有「用 class 找元素」的內建方法?雖然高版本瀏覽器早已支援 getElementsByClassName(),但為了相容舊版,還是需要自己封裝。以下用五個版本示範這個函式如何一步步演進。
function getByClass1(parent, cls){
var res = [];
var ele = parent.getElementsByTagName('*');
for (var i = 0; i < ele.length; i++) {
if (ele[i].className == cls) { res.push(ele[i]); }
}
return res;
}
當 class 只有一個值時沒問題,但多 class 就會漏:
<div class="test"></div> <div class="test box"></div> <script> getByClass1(document, 'test'); // 只抓到第一個 div </script>
function getByClass2(parent, cls){
var res = [];
var reg = new RegExp('\\b' + cls + '\\b', 'i'); // 比對獨立單字
var ele = parent.getElementsByTagName('*');
for (var i = 0; i < ele.length; i++) {
if (reg.test(ele[i].className)) { res.push(ele[i]); }
}
return res;
}
這看似解決了問題,卻藏著一個 bug:
<div class="test"></div> <div class="test_box"></div> <div class="test-box"></div> <script> getByClass2(document, 'test'); // 抓到第一個「和」第三個 </script>
問題出在 \b。它是正則裡的「單字邊界」,會把字母、數字、底線以外的字元都當成邊界,所以 test-box 裡的連字號被視為分界,於是也被匹配上了。
function getByClass3(parent, cls){
var res = [];
var reg = new RegExp(' ' + cls + ' ', 'i'); // 兩側必須有空格
var ele = parent.getElementsByTagName('*');
for (var i = 0; i < ele.length; i++) {
if (reg.test(' ' + ele[i].className + ' ')) { res.push(ele[i]); }
}
return res;
}
做法是先在 className 兩側補上空格,保證每個 class 值左右都有空格,再用正則比對。使用時要注意單引號內的空格不能漏掉。
function getByClass4(parent, cls){
var res = [];
var reg = new RegExp('(^|\\s)' + cls + '($|\\s)', 'i');
var ele = parent.getElementsByTagName('*');
for (var i = 0; i < ele.length; i++) {
if (reg.test(ele[i].className)) { res.push(ele[i]); }
}
return res;
}
用 (^|\s) 與 ($|\s) 明確表示「開頭或空白」與「結尾或空白」,不必手動補空格,程式碼也更乾淨。
function getByClass(parent, cls){
if (parent.getElementsByClassName) {
return parent.getElementsByClassName(cls);
} else {
var res = [];
var reg = new RegExp(' ' + cls + ' ', 'i');
var ele = parent.getElementsByTagName('*');
for (var i = 0; i < ele.length; i++) {
if (reg.test(' ' + ele[i].className + ' ')) { res.push(ele[i]); }
}
return res;
}
}
有原生方法就用原生(效能好得多),沒有才退回手寫實作,這是最實用的折衷。
這個問題在現在已經有標準答案:document.querySelectorAll('.test')。它支援多 class、層級選擇器,並回傳靜態的 NodeList,相容性也涵蓋所有仍在服役的瀏覽器:
document.querySelectorAll('.test'); // 所有含 test 的元素
document.querySelectorAll('#wrap .test'); // 限定在 #wrap 內
上面五個版本的價值在於理解背後的原理——尤其正則邊界那個坑,是很多人寫過之後才懂的經驗。