萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 獲取表單元素值的標準方法:DOM API 與 FormData 完整指南

獲取表單元素值是前端基礎功。本文系統梳理原生 DOM API、FormData 現代標準、jQuery 簡化方式,對比各方案優劣與適用場景。

核心 DOM API

1. 獲取表單對象


// 方式一:ID 獲取
var form = document.getElementById("myForm");

// 方式二:name 獲取(文檔表單集合)
var form = document.forms["myForm"]; // 或 document.myForm

// 方式三:元素向上查找
var form = document.querySelector("input[name=username]").form;

2. 獲取字段值


// 通用: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);
}

3. 設置字段值


// 文本/密碼/隱藏域
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";

現代標準:FormData(推薦)


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;
    }
}

jQuery 簡化方式


// 序列化為查詢字符串: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標準化、自動處理所有類型、支援文件、直接 AJAXIE10+、需轉換為 JSON 時稍繁瑣現代項目、表單提交、文件上傳
jQueryAPI 簡潔、鏈式調用、兼容性好依賴 jQuery、serialize 不含文件、性能較低jQuery 項目、快速開發、簡單表單

最佳實踐清單

  1. ✅ 現代項目首選 `FormData` + `fetch`
  2. ✅ 表單元素統一設置 `name` 屬性(非 id)
  3. ✅ 多選框/多選下拉 `name` 加 `[]` 後綴(PHP/Java 友好):`name="hobby[]"`
  4. ✅ 提交前驗證用 `form.checkValidity()` (HTML5 原生驗證)
  5. ✅ 禁用字段不提交:`` 或 `formData.delete("field")`
  6. ✅ 文件上傳必須 `enctype="multipart/form-data"` + `FormData`

掌握這三套方案,根據項目技術棧靈活選擇,表單數據處理將不再是痛點。

copyright © 萬盛學電腦網 all rights reserved