獲取表單元素值是前端基礎功。本文系統梳理原生 DOM API、FormData 現代標準、jQuery 簡化方式,對比各方案優劣與適用場景。
// 方式一:ID 獲取
var form = document.getElementById("myForm");
// 方式二:name 獲取(文檔表單集合)
var form = document.forms["myForm"]; // 或 document.myForm
// 方式三:元素向上查找
var form = document.querySelector("input[name=username]").form;
// 通用:form.elements 集合(包含所有表單控件)
var form = document.getElementById("myForm");
// 文本/密碼/隱藏域/單選/下拉:直接 .value
var username = form.elements["username"].value; // 或 form.username.value
var password = form.elements["password"].value;
// 單選框:同 name 取選中值
var gender = form.elements["gender"].value; // 自動獲取選中的 value
// 多選框:需遍歷
var hobbies = [];
var checkboxes = form.elements["hobby"]; // RadioNodeList / HTMLCollection
for (var i = 0; i < checkboxes.length; i++) {
if (checkboxes[i].checked) hobbies.push(checkboxes[i].value);
}
// 下拉選單
var citySelect = form.elements["city"];
var cityValue = citySelect.value;
var cityText = citySelect.options[citySelect.selectedIndex].text;
// 多選下拉
var multiValues = [];
var options = citySelect.options;
for (var i = 0; i < options.length; i++) {
if (options[i].selected) multiValues.push(options[i].value);
}
// 文本/密碼/隱藏域
form.elements["username"].value = "李四";
// 單選框:設置 value 自動選中匹配項
form.elements["gender"].value = "1";
// 多選框:需遍歷設置
var values = ["1", "3"];
var checkboxes = form.elements["hobby"];
for (var i = 0; i < checkboxes.length; i++) {
checkboxes[i].checked = values.indexOf(checkboxes[i].value) > -1;
}
// 下拉選單
form.elements["city"].value = "sh";
var form = document.getElementById("myForm");
var formData = new FormData(form);
// 獲取
formData.get("username"); // 單值
formData.getAll("hobby"); // 多值數組
// 設置/修改
formData.set("username", "新值");
formData.append("hobby", "新愛好"); // 多值追加
formData.delete("token"); // 刪除
// 遍歷
for (var [key, value] of formData.entries()) {
console.log(key, value);
}
// 直接發送 AJAX(自動設置 Content-Type: multipart/form-data)
fetch("/api/submit", {method: "POST", body: formData});
// 轉為 JSON 物件(需處理多值)
var obj = {};
for (var [key, value] of formData.entries()) {
if (obj[key]) {
obj[key] = Array.isArray(obj[key]) ? obj[key] : [obj[key]];
obj[key].push(value);
} else {
obj[key] = value;
}
}
// 序列化為查詢字符串:a=1&b=2&b=3
var queryString = $("#myForm").serialize();
// 序列化為數組:[{name:"a",value:"1"}, {name:"b",value:"2"}, ...]
var array = $("#myForm").serializeArray();
// 獲取單個值
$("#myForm input[name=username]").val();
$("#myForm input[name=gender]:checked").val();
$("#myForm select[name=city]").val();
// 設置值
$("#myForm input[name=username]").val("新值");
$("#myForm input[name=gender][value=1]").prop("checked", true);
$("#myForm select[name=city]").val("sh");
| 方案 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| 原生 DOM API | 零依賴、性能最好、完全控制 | 代碼冗長、多選框/下拉需手動遍歷 | 無框架項目、高性能要求、庫開發 |
| FormData | 標準化、自動處理所有類型、支援文件、直接 AJAX | IE10+、需轉換為 JSON 時稍繁瑣 | 現代項目、表單提交、文件上傳 |
| jQuery | API 簡潔、鏈式調用、兼容性好 | 依賴 jQuery、serialize 不含文件、性能較低 | jQuery 項目、快速開發、簡單表單 |
掌握這三套方案,根據項目技術棧靈活選擇,表單數據處理將不再是痛點。