要操作頁面,第一步永遠是「拿到那個元素」。JavaScript 提供了幾種獲取方式,各自的返回結果和適用場景並不相同,用錯了就會出現「明明寫了卻取不到」的情況。
document.getElementById(ID) // 獲得指定 ID 的單個元素 document.getElementsByName(Name) // 獲得指定 name 的元素集合 document.getElementsByTagName(tag) // 獲得指定標簽名的元素集合 document.all[name] // 文檔中所有元素的集合(非標準)
通過 ID 取元素,返回單個元素對象。它之所以可靠,是因為整個頁面中一個元素的 ID 值應當唯一,所以返回值能確保就是你要的那一個。
var organizationId = document.getElementById("organizationId");
alert(organizationId.value);
找不到時返回 null,所以使用前建議判斷一下,或者直接用 if (el)。ID 不存在的情況在模板條件渲染的頁面裡並不少見。
通過 name 屬性取元素,返回的是一個 NodeList。即使整個頁面中只有一個 name 匹配的對象,它也會以集合形式返回,此時集合長度為 1。
var organizationId = document.getElementsByName("organizationId");
alert(organizationId[0].value);
alert(organizationId.length);
必須用下標訪問,這是與 getElementById 最容易搞混的地方。這個方法特別適合處理一組同名的單選框。
通過標簽名取元素。一個文檔裡同類標簽通常有很多,所以它同樣返回集合。
var inputs = document.getElementsByTagName("input");
alert(inputs.length);
alert(inputs[0].value);
alert(inputs[1].value);
實務中經常配合篩選使用:
// 取某個容器內的所有 input,避免影響頁面其他部分
var box = document.getElementById('myForm');
var inputs = box.getElementsByTagName('input');
document.all 是文檔中所有標簽組成的一個集合,包含文檔對象裡的所有元素。它比 getElementsByName 「智能」一點:符合條件的對象只有一個時直接返回該對象,有多個時才以集合形式返回。
var organizationId = document.all["organizationId"];
alert(organizationId[0].value);
// 兩種等價寫法
document.all["organizationId"]
document.all.item("organizationId")
正因為這種「返回值類型不確定」的特性,它反而更容易出錯——你永遠不確定拿到的是元素還是集合。加上它屬於 IE 專屬的非標準擴展,現代代碼不應使用。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>New Document</TITLE>
</HEAD>
<BODY>
<form method="post" name="mainFrm" action="">
<input type="hidden" name="text" id="text" value="練習而已">
<input type="hidden" name="organizationId" value="驗證 DOCUMENT.ALL">
<table width="100%" border="1">
<tr height="22">
<td width="15%" align="right">庫存組織:</td>
<td width="20%">
<input type="text" name="organizationId" id="organizationId" value="庫存組織">
</td>
</tr>
<tr>
<td width="15%" align="right">子庫編碼:</td>
<td width="20%">
<select name="subinventoryCode" id="subinventoryCode">
<option value="QTWL">QTWL</option>
<option value="BTSPT">BTSPT</option>
<option value="BTS">BTS</option>
</select>
</td>
</tr>
<tr height="22">
<td colspan="2" align="center">
<input type="button" value="獲取指定對象" onclick="do_check()">
</td>
</tr>
</table>
</form>
</BODY>
</HTML>
注意示例中有一個值得留意的細節:那個隐藏的 input 和可見的 text input 用了相同的 name(organizationId),但 id 只有可見的那個有。這正好演示了兩種方法的性差異——用 getElementById 拿到的是可見元素,用 getElementsByName 拿到的是長度為 2 的集合。實際項目中應該避免這種重名,它只會給後續維護埋坑。
今天寫新代碼,優先用 CSS 選擇器語法,表達能力強得多:
document.querySelector('#organizationId'); // 單個,等於 getElementById
document.querySelectorAll('input[name=organizationId]'); // 集合
document.querySelectorAll('.tab_menu li.selected'); // 複雜選擇器
document.querySelector('#myForm input[type=text]'); // 層次選擇器
querySelector 返回第一個匹配元素或 null,querySelectorAll 返回靜態 NodeList(不像 getElementsBy* 那樣是實時的,DOM 變化後不會自動更新)。這個「靜態 vs 實時」的性差異,是選擇 API 時值得考慮的實際因素。