用 JavaScript 操作表單與操作 DOM 是一樣的觀念,因為表單本身就是 DOM 樹的一部分。
差別在於表單的輸入框、下拉選單等能接收使用者輸入,所以用 JavaScript 操作表單,可以取得使用者輸入的內容,也能反向設定輸入框的值。
HTML 表單的輸入控制項主要有以下幾種:
若已取得一個 <input> 節點的參照,直接呼叫 value 就能拿到使用者輸入的值:
// <input type="text" id="email">
var input = document.getElementById('email');
input.value; // '用戶輸入的值'
這招適用於 text、password、hidden 與 select。但單選鈕與核取方塊不同——value 回傳的永遠是 HTML 上寫死的預設值,我們真正想知道的是使用者「有沒有勾選」,因此要用 checked 判斷:
// <label><input type="radio" name="weekday" id="monday" value="1"> Monday</label>
// <label><input type="radio" name="weekday" id="tuesday" value="2"> Tuesday</label>
var mon = document.getElementById('monday');
var tue = document.getElementById('tuesday');
mon.value; // '1'
tue.value; // '2'
mon.checked; // true或者false
tue.checked; // true或者false
設值的方式與取值類似。對於 text、password、hidden 與 select,直接指定 value 即可:
// <input type="text" id="email">
var input = document.getElementById('email');
input.value = 'test@example.com'; // 文本框的內容已更新
單選鈕與核取方塊則是把 checked 設為 true 或 false。
HTML5 新增了大量標準控制項,常見的有 date、datetime、datetime-local、color 等,它們同樣使用 <input> 標籤:
<input type="date" value="2015-07-01"> <input type="datetime-local" value="2015-07-01T02:03:04"> <input type="color" value="#ff0000">
不支援 HTML5 的瀏覽器無法識別這些新型別,會當成 type="text" 顯示;支援的瀏覽器則會給出格式化後的字串。例如 type="date" 的 value 保證是有效的 YYYY-MM-DD 日期或空字串,省下不少驗證功夫。
最後,JavaScript 有兩種方式處理表單提交(AJAX 的方式留待後續說明)。
方式一是呼叫 <form> 元素的 submit() 方法,例如回應某個 <button> 的 click 事件,在程式碼中提交:
<!-- HTML -->
<form id="test-form">
<input type="text" name="test">
<button type="button" onclick="doSubmitForm()">Submit</button>
</form>
<script>
function doSubmitForm() {
var form = document.getElementById('test-form');
// 可以在此修改form的input...
// 提交form:
form.submit();
}
</script>
這種寫法缺點是打亂了瀏覽器對表單的正常提交流程。瀏覽器預設在按下 <button type="submit"> 或於最後一個輸入框按 Enter 時送出表單,因此更好的方式是回應 <form> 本身的 onsubmit 事件,在提交時機做處理:
<!-- HTML -->
<form id="test-form" onsubmit="return checkForm()">
<input type="text" name="test">
<button type="submit">Submit</button>
</form>
<script>
function checkForm() {
var form = document.getElementById('test-form');
// 可以在此修改form的input...
// 繼續下一步:
return true;
}
</script>
記得 return true 才是告訴瀏覽器繼續提交;若 return false,瀏覽器不會送出表單。這通常用於使用者輸入有誤的情況:提示錯誤訊息後中止提交。
在檢查與修改 <input> 時,要善用 <input type="hidden"> 來傳遞資料。
舉例來說,許多登入表單希望使用者輸入帳號與密碼,但基於安全考量,送出時不傳明文密碼,而是傳它的 MD5。一般做法會直接改寫 <input>:
<!-- HTML -->
<form id="login-form" method="post" onsubmit="return checkForm()">
<input type="text" id="username" name="username">
<input type="password" id="password" name="password">
<button type="submit">Submit</button>
</form>
<script>
function checkForm() {
var pwd = document.getElementById('password');
// 把用戶輸入的明文變為MD5:
pwd.value = toMD5(pwd.value);
// 繼續下一步:
return true;
}
</script>
表面看沒問題,但使用者按下送出時,密碼框的星號會突然從幾個變成 32 個(MD5 的長度)。
若不想改變使用者的輸入畫面,可以改用 <input type="hidden">:
<!-- HTML -->
<form id="login-form" method="post" onsubmit="return checkForm()">
<input type="text" id="username" name="username">
<input type="password" id="input-password">
<input type="hidden" id="md5-password" name="password">
<button type="submit">Submit</button>
</form>
<script>
function checkForm() {
var input_pwd = document.getElementById('input-password');
var md5_pwd = document.getElementById('md5-password');
// 把用戶輸入的明文變為MD5:
md5_pwd.value = toMD5(input_pwd.value);
// 繼續下一步:
return true;
}
</script>
注意 id 為 md5-password 的 <input> 標了 name="password",而使用者輸入的 id 為 input-password 那個則沒有 name 屬性——沒有 name 的 <input>,其資料不會被送出。這正是整個技巧能成立的關鍵,也是「name 決定是否提交、id 只供 JavaScript 取用」這條規則的實際應用。