表單數據獲取是 Web 開發基礎,但不同控件(單選、多選、下拉)獲取方式各異。本文系統梳理前端 JS 與後端 Java 獲取各類表單元素的標準方法,附完整代碼對照。
<form id="userForm" action="/submit" method="POST">
<!-- 文本/密碼 -->
<input type="text" name="username" value="張三">
<input type="password" name="password">
<!-- 單選框:同 name,不同 value -->
<input type="radio" name="gender" value="1"> 男
<input type="radio" name="gender" value="2" checked> 女
<!-- 多選框:同 name,可多選 -->
<input type="checkbox" name="hobby" value="1"> 足球
<input type="checkbox" name="hobby" value="2" checked> 籃球
<input type="checkbox" name="hobby" value="3"> 游泳
<!-- 隱藏域 -->
<input type="hidden" name="token" value="abc123">
<!-- 下拉選單 -->
<select name="city" id="city">
<option value="bj">北京</option>
<option value="sh" selected>上海</option>
<option value="gz">廣州</option>
</select>
<button type="submit">提交</button>
</form>
var form = document.getElementById("userForm");
var formData = new FormData(form);
// 獲取單值
formData.get("username"); // "張三"
formData.get("gender"); // "2" (單選取選中值)
formData.get("city"); // "sh"
// 獲取多值(多選框/多選下拉)
formData.getAll("hobby"); // ["2"] (只取選中的)
// 遍歷所有
for (var [key, value] of formData.entries()) {
console.log(key, value);
}
// 直接發送 AJAX
fetch("/api/submit", {method: "POST", body: formData});
var form = document.getElementById("userForm");
// 文本/密碼/隱藏域/單選/下拉:同 name 取首個
form.username.value; // "張三"
form.elements["gender"].value; // "2" (單選自動取選中項)
// 多選框:需遍歷
var hobbies = [];
var checkboxes = form.elements["hobby"]; // HTMLCollection
for (var i = 0; i < checkboxes.length; i++) {
if (checkboxes[i].checked) {
hobbies.push(checkboxes[i].value);
}
}
// hobbies = ["2"]
// 下拉選單:獲取文本而非值
var citySelect = form.elements["city"];
var cityText = citySelect.options[citySelect.selectedIndex].text; // "上海"
// 序列化為字符串:name1=val1&name2=val2...
var params = $("#userForm").serialize();
// "username=張三&gender=2&hobby=2&token=abc123&city=sh"
// 序列化為數組對象:[{name:"username",value:"張三"}, ...]
var arr = $("#userForm").serializeArray();
// 直接獲取值
$("#userForm input[name='username']").val(); // "張三"
$("#userForm input[name='gender']:checked").val(); // "2"
$("#userForm input[name='hobby']:checked").map(function() { return this.value; }).get(); // ["2"]
$("#userForm select[name='city']").val(); // "sh"
$("#userForm select[name='city'] option:selected").text(); // "上海"
@WebServlet("/submit")
public class FormServlet extends HttpServlet {
protected void doPost(HttpServletRequest req, HttpServletResponse resp) {
// 單值:文本、密碼、隱藏域、單選、下拉(單選)
String username = req.getParameter("username"); // "張三"
String gender = req.getParameter("gender"); // "2"
String city = req.getParameter("city"); // "sh"
String token = req.getParameter("token"); // "abc123"
// 多值:多選框、多選下拉
String[] hobbies = req.getParameterValues("hobby"); // ["2"]
// 若無勾選,返回 null(非空數組),需判空
// 獲取所有參數名
Enumeration names = req.getParameterNames();
}
}
// 1. 簡單參數綁定
@PostMapping("/submit")
public Result submit(
@RequestParam String username,
@RequestParam String gender,
@RequestParam(required = false) String[] hobby, // 多選框自動綁定數組
@RequestParam String city,
@RequestParam String token
) { ... }
// 2. 對象綁定(最常用)
@Data
public class UserForm {
private String username;
private String password;
private String gender;
private String[] hobby; // 或 List
private String city;
private String token;
}
@PostMapping("/submit")
public Result submit(@ModelAttribute UserForm form) {
// 自動綁定所有字段,多選框自動轉數組/List
// 驗證:@Valid + BindingResult
}
// 表單需 enctype="multipart/form-data"
// Spring
@PostMapping("/upload")
public Result upload(@RequestParam("file") MultipartFile file, UserForm form) {
// file.getOriginalFilename(), file.getBytes(), file.transferTo(...)
}
| 控件類型 | JS 獲取關鍵點 | Java 獲取關鍵點 |
|---|---|---|
| 單選框 | 同 name,`:checked` 獲取選中值 | `getParameter` 直接獲取選中值 |
| 多選框 | `getAll` / `:checked` 遍歷 / `serialize` 自動處理 | `getParameterValues` 返回數組,無選中則 null |
| 下拉單選 | `.val()` 獲取 value,`option:selected` 獲取文本 | `getParameter` 獲取 value |
| 下拉多選 | `.val()` 返回數組 | `getParameterValues` 返回數組 |
| 未勾選多選框 | JS 獲取空數組 | Java 返回 null (易漏判空) |
| 禁用控件 | JS 可獲取 | Java 不會 接收 disabled 控件數據 |
掌握前後端表單數據流轉全鏈路,是構建健壯 Web 應用的基本功。