萬盛學電腦網

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

jQuery 獲取控件值完全指南:三大類方法、ASP.NET 控件特殊處理與最佳實踐

jQuery 獲取控件值看似簡單,實則有 DOM 屬性、jQuery 方法、屬性操作三類 API,且 ASP.NET 服務端控件 ID 渲染差異帶來特殊挑戰。本文系統梳理所有獲取/設置方式,建立統一認知標準。

核心概念區分

  • DOM 元素屬性:`element.value`、`element.checked`、`element.selectedIndex` —— 原生、最快、最直接
  • jQuery 方法:`$el.val()`、`$el.prop()`、`$el.is()` —— 封裝、鏈式、跨瀏覽器統一
  • jQuery 屬性操作:`$el.attr("value")`、`$el.attr("checked")` —— 操作 HTML 屬性,**非**當前狀態

ASP.NET 服務端控件 ID 問題與解決

ASP.NET WebForms 渲染時會重寫 ID(如 `ctl00_ContentPlaceHolder1_txtUserID`)。三種選擇器策略:


// 1. 內嵌代碼塊輸出 ClientID(最精確,需 .aspx 頁面內聯腳本)
$("#<%= txtUserID.ClientID %>").val();

// 2. 屬性結尾匹配(通用,性能稍弱)
$("input[id$='txtUserID']").val();

// 3. 屬性包含匹配(較寬鬆)
$("input[id*='txtUserID']").val();

// 推薦:給控件添加固定 CssClass

// JS 中
$(".js-user-id").val();

各類控件獲取/設置值對照表

控件類型獲取值 (推薦)設置值 (推薦)備選方案
文本框/文本域/隱藏域/密碼框`.val()``.val("新值")``[0].value` / `.attr("value")`
單選框`$("input[name=sex]:checked").val()``$("input[name=sex][value=1]").prop("checked", true)`原生 `form.sex.value`
多選框`$("input[name=hobby]:checked").map(...).get()``$("input[name=hobby][value=1]").prop("checked", true)`FormData.getAll()
下拉單選`.val()``.val("值")``[0].selectedIndex = 1`
下拉多選`.val()` (返回數組)`.val(["值1", "值2"])`遍歷 option 設置 selected
按鈕/提交按鈕`.val()``.val("新文本")``.text("新文本")` (button 標籤)

常見錯誤與正確寫法對比

❌ 錯誤:混淆 attr 與 val/prop


// 文本框
$("#txt").attr("value", "新值"); // 僅修改 HTML 屬性,界面不一定更新(視瀏覽器)
$("#txt").val("新值");           // 正確:修改 DOM property,界面即時更新

// Checkbox
$("#chk").attr("checked", true); // jQuery 1.6+ 僅設置屬性,不改變勾選狀態
$("#chk").prop("checked", true); // 正確:修改 DOM property

❌ 錯誤:對 jQuery 對象直接取 .value


var val = $("#txt").value; // undefined!jQuery 對象無 value 屬性
var val = $("#txt")[0].value; // 正確:取原生 DOM
var val = $("#txt").val();    // 推薦:jQuery 方法

進階:批量表單數據收集

1. serialize() - URL 編碼字符串


var params = $("#form").serialize();
// "username=張三&gender=1&hobby=2&hobby=3&city=bj"

2. serializeArray() - 對象數組


var arr = $("#form").serializeArray();
// [{name:"username",value:"張三"}, {name:"gender",value:"1"}, ...]

3. 手動構建 JSON(處理巢狀/複雜結構)


function formToJson($form) {
    var data = {};
    $form.serializeArray().forEach(function(field) {
        if (data[field.name]) {
            data[field.name] = Array.isArray(data[field.name]) ? data[field.name] : [data[field.name]];
            data[field.name].push(field.value);
        } else {
            data[field.name] = field.value;
        }
    });
    return data;
}

DropDownList (ASP.NET) 專用獲取


// ASPX

    北京
    上海


// JS (內聯腳本)
var value = $("#<%= ddlCity.ClientID %> option:selected").val(); // "bj"
var text = $("#<%= ddlCity.ClientID %> option:selected").text(); // "北京"

// 設置選中
$("#<%= ddlCity.ClientID %>").val("sh");

現代化建議:拥抱原生 + 封裝工具函數


// 輕量級表單工具(無依賴)
const FormUtil = {
    getValues(form) {
        const fd = new FormData(form);
        const data = {};
        for (let [k, v] of fd.entries()) {
            data[k] = data[k] ? [].concat(data[k], v) : v;
        }
        return data;
    },
    setValues(form, data) {
        for (let [k, v] of Object.entries(data)) {
            const el = form.elements.namedItem(k);
            if (!el) continue;
            if (el.type === "select-multiple") {
                [...el.options].forEach(o => o.selected = Array.isArray(v) ? v.includes(o.value) : o.value === v);
            } else if (el.type === "radio") {
                [...form.elements.namedItem(k)].forEach(r => r.checked = r.value === v);
            } else if (el.type === "checkbox") {
                el.checked = Array.isArray(v) ? v.includes(el.value) : (el.value === v || v === true);
            } else {
                el.value = v;
            }
        }
    }
};

// 使用
const data = FormUtil.getValues(document.getElementById("myForm"));
FormUtil.setValues(document.getElementById("myForm"), {username: "李四", hobby: ["1", "3"]});

建立「DOM Property vs HTML Attribute vs jQuery Method」的清晰心智模型,是寫出無 Bug 表單交互代碼的前提。

copyright © 萬盛學電腦網 all rights reserved