表單取值看起來簡單,真正動手才會發現細節一堆:同名 radio 要回傳單一值、checkbox 要回傳多值、multiple 的 select 又是另一套邏輯,disabled 的欄位還不能送出去。本文把這些操作全部封裝成一個 formUtil 物件,順便加上表單序列化,之後專案直接拿去用即可。
var formUtil = {
// 取得單選按鈕的值;沒有任何選項被勾選時回傳 null
// elements 為同名 radio 集合的引用
getRadioValue: function (elements) {
var value = null; // null 代表沒有選中項
// 非 IE 瀏覽器:同名 radio 集合在部分實作下可直接取 value
if (elements.value != undefined && elements.value != '') {
value = elements.value;
} else {
// IE 需要逐一走訪
for (var i = 0, len = elements.length; i < len; i++) {
if (elements[i].checked) {
value = elements[i].value;
break;
}
}
}
return value;
},
// 取得多選按鈕的值;沒勾選時回傳 null
// elements 為 checkbox 集合的引用
getCheckboxValue: function (elements) {
var arr = [];
for (var i = 0, len = elements.length; i < len; i++) {
if (elements[i].checked) {
arr.push(elements[i].value);
}
}
return arr.length > 0 ? arr.join(',') : null;
},
// 取得下拉框的值,同時處理單選與 multiple 複選
getSelectValue: function (element) {
if (element.selectedIndex == -1) {
return null; // 沒有任何選項被選
}
if (element.multiple) {
var arr = [], options = element.options;
for (var i = 0, len = options.length; i < len; i++) {
if (options[i].selected) {
arr.push(options[i].value);
}
}
return arr.join(',');
}
return element.options[element.selectedIndex].value;
},
// 序列化:把整個表單轉成 query string 形式
serialize: function (form) {
var arr = [], elements = form.elements, checkboxName = null;
for (var i = 0, len = elements.length; i < len; i++) {
var field = elements[i];
// 停用的欄位不送出
if (field.disabled) continue;
switch (field.type) {
// 下拉選單
case "select-one":
case "select-multiple":
arr.push(encodeURIComponent(field.name) + "=" + encodeURIComponent(this.getSelectValue(field)));
break;
// 這些類型不需要序列化
case undefined:
case "button":
case "submit":
case "reset":
case "file":
break;
// checkbox:同名只需處理一次
case "checkbox":
if (checkboxName == null) {
checkboxName = field.name;
arr.push(encodeURIComponent(checkboxName) + "="
+ encodeURIComponent(this.getCheckboxValue(form.elements[checkboxName])));
}
break;
// radio:只送被選中的那一個
case "radio":
if (!field.checked) break;
default:
if (field.name.length > 0) {
arr.push(encodeURIComponent(field.name) + "=" + encodeURIComponent(field.value));
}
}
}
return arr.join("&");
}
};
<form action="test_php.php" id="form1" name="form1" method="post" enctype="multipart/form-data">
姓名:<input name="name" type="text" tabindex="1" /><br>
性別:<input name="sex" type="radio" value="男"/> 男
<input name="sex" type="radio" value="女" /> 女<br>
愛好:<input name="hobby" type="checkbox" value="籃球" /> 籃球
<input name="hobby" type="checkbox" value="足球" /> 足球
<input name="hobby" type="checkbox" value="乒乓球" /> 乒乓球
<input name="hobby" type="checkbox" value="羽毛球" /> 羽毛球<br />
年級:<select name="class" multiple>
<option value="一年級">一年級</option>
<option value="二年級">二年級</option>
<option value="三年級">三年級</option>
</select><br />
其他:<br />
<textarea name="other" rows="5" cols="30" tabindex="2"></textarea><br />
<input type="reset" value="重置" />
<input type="submit" value="提交" />
</form>
<div id="output"></div>
var form = document.getElementById("form1"),
output = document.getElementById("output");
// 攔截 submit,改用自訂邏輯處理
EventUtil.addEventListener(form, "submit", function (event) {
event = EventUtil.getEvent(event);
EventUtil.preventDefault(event);
var html = "";
html += form.elements['name'].value + "<br>";
html += formUtil.getRadioValue(form.elements['sex']) + "<br>";
html += formUtil.getCheckboxValue(form.elements['hobby']) + "<br>";
html += formUtil.getSelectValue(form.elements['class']) + "<br>";
html += form.elements['other'].value + "<br>";
html += decodeURIComponent(formUtil.serialize(form)) + "<br>";
output.innerHTML = html;
});
第一,getRadioValue 開頭那段「直接取 elements.value」的分支,是為了相容早期瀏覽器的實作差異;在現代瀏覽器裡,同名 radio 的集合本身確實帶有 value,但與其依賴這種行為,不如永遠走逐一走訪的分支,邏輯更明確也更好維護。
第二,序列化時務必對名稱與值都做一次 encodeURIComponent,否則遇到中文、&、= 這類字元就會把 query string 打壞。
第三,如果專案已經引入 jQuery,$('#form1').serialize() 一行就能完成同樣的事,而且處理得比手寫版本更嚴謹(例如 select multiple 全部未選時的正確行為)。手寫版本的價值在於理解底層規則,以及在没有框架的環境裡隨手可用。
以上就是這套表單取值與序列化的封裝,希望對大家的學習有幫助。