在 jQuery 普及之前,抓元素只有那幾個原生方法可用。搞懂它們的回傳差異,不只對維護舊專案有幫助,也能更清楚理解 jQuery 選擇器背後在做什麼。
最常用的一個,依 id 定位。因為 id 在文件中必須唯一,所以回傳的是單一元素節點。
var test = document.getElementById("test").value; // 取出 id 為 test 的元素值
依 name 屬性挑選,回傳的是 NodeList(類陣列),即使只符合一筆也是集合。
var test = document.getElementsByName("test");
alert(test.length); // 符合的數量
var test = document.getElementsByTagName("div"); // 所有 div 元素
同樣回傳集合。注意參數是標籤名稱(如 "div"),不是 class 名稱。
這個方法在早期 JavaScript API 裡根本不存在,想用必須自己實作。原理通常是先用 getElementsByTagName("*") 取出全部元素,再遍歷比對 className。以下是兩個經典實作:
(1)Robert Nyman 的版本(2005 年)
// 三個參數都是必要的
// 在 5007 個元素中搜尋 class 為 "cell" 的項目,實測耗時:
// IE8 約 1828~1844ms、IE6 約 4610~6109ms、FF3.5 約 46~48ms
// Opera 10 約 31~32ms、Chrome 約 23~26ms、Safari 4 約 19~20ms
function getElementsByClassName(oElm, strTagName, strClassName) {
var arrElements = (strTagName == "*" && oElm.all)
? oElm.all : oElm.getElementsByTagName(strTagName);
var arrReturnElements = new Array();
strClassName = strClassName.replace(/-/g, "\\-");
var oRegExp = new RegExp("(^|\\s)" + strClassName + "(\\s|$)");
var oElement;
for (var i = 0; i < arrElements.length; i++) {
oElement = arrElements[i];
if (oRegExp.test(oElement.className)) {
arrReturnElements.push(oElement);
}
}
return arrReturnElements;
}
(2)Dustin Diaz 的版本(《JavaScript Design Patterns》作者),程式碼較短,但不支援 IE5。
// 在 5007 個元素中搜尋 class 為 "cell" 的項目,實測耗時:
// IE8 約 78ms、IE6 約 125~171ms、FF3.5 約 42~48ms
// Opera 10 約 31ms、Chrome 約 22~25ms、Safari 4 約 18~19ms
var getElementsByClass = function (searchClass, node, tag) {
var classElements = [];
if (node == null) node = document;
if (tag == null) tag = '*';
var els = node.getElementsByTagName(tag);
var pattern = new RegExp("(^|\\s)" + searchClass + "(\\s|$)");
for (var i = 0, j = 0; i < els.length; i++) {
if (pattern.test(els[i].className)) classElements[j++] = els[i];
}
return classElements;
};
兩份實作的效能差距,主要來自是否額外處理 document.all 這種 IE 專屬捷徑。而如果負擔得起,現代瀏覽器都原生支援 document.getElementsByClassName('cell') 與 document.querySelectorAll('.cell'),一行取代上面全部程式碼,且速度更快。
// 提交 id 為 test 的表單
document.getElementById("test").submit();
// 設定 id 為 test 元素的邊框
document.getElementById("test").style.border = "2px solid red";
// 滑鼠移入/移出時改變另一個元素的背景色
function test() {
document.getElementById("test").onmouseover = function () {
document.getElementById("test2").style.backgroundColor = "red";
};
document.getElementById("test").onmouseout = function () {
document.getElementById("test2").style.backgroundColor = "blue";
};
}
// 統計 name 為 test 的元素個數
function count() {
alert(document.getElementsByName("test").length);
}
補充一個關鍵觀念:事件處理函式裡的 this 指向綁定事件的當前元素,因此上面可以簡寫成 this.style.backgroundColor = 'red',不必重複呼叫 getElementById。另外,getElementsByClassName 與 querySelectorAll 回傳的是靜態 NodeList,而 getElementsByTagName 回傳的是「live」集合——文件一改動,集合內容會即時跟著變,這點在迴圈中特別容易踩坑,記得先轉成陣列再操作。