萬盛學電腦網

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

jQuery 表單元素操作大全(增強版):Select/Input/Radio/Checkbox 統一最佳實踐

本文在 71158 基礎上深化,修正舊版語法 (@ 選擇器),補充動態構建、數據綁定、驗證集成、TypeScript 類型、無障礙支持,構建生產級表單操作參考手冊。

一、現代選擇器語法對照 (jQuery 3.x+)


// ❌ 棄用
$("input[@name='sex'][@checked]")
$("select[@name='country'] option[@selected]")

// ✅ 標準
$("input[name='sex']:checked")
$("select[name='country'] option:selected")
$("input[type='radio']:checked")
$("input[type='checkbox']:checked")

二、統一數據模型:表單 → 對象 / 對象 → 表單

1. 表單序列化為標準對象 (含多值處理)


/**
 * 將表單序列化為 { name: value } 對象
 * - 同名 checkbox/radio/select-multiple → 陣列
 * - 其他 → 字符串
 */
export function serializeForm($form) {
    const data = {};
    $form.serializeArray().forEach(({name, value}) => {
        if (data[name] !== undefined) {
            data[name] = Array.isArray(data[name]) ? [...data[name], value] : [data[name], value];
        } else {
            data[name] = value;
        }
    });
    return data;
}

// 使用
const formData = serializeForm($('#myForm'));
// { username: "admin", roles: ["admin","editor"], theme: "dark" }

2. 數據回填表單 (通用、健壯)


/**
 * 將數據對象回填到表單
 * 支持: text/password/textarea/hidden/select/radio/checkbox/file(僅清空)
 */
export function populateForm($form, data) {
    Object.entries(data).forEach(([name, value]) => {
        const $ctrls = $form.find(`[name="${CSS.escape(name)}"]`);
        if (!$ctrls.length) return;
        
        const type = $ctrls.attr('type');
        const tag = $ctrls.prop('tagName').toLowerCase();
        
        if (tag === 'select') {
            const vals = Array.isArray(value) ? value : [value];
            $ctrls.val(vals.map(String)); // 統一轉字符串匹配
        } else if (type === 'radio') {
            $ctrls.filter(`[value="${CSS.escape(String(value))}"]`).prop('checked', true);
        } else if (type === 'checkbox') {
            const vals = Array.isArray(value) ? value.map(String) : [String(value)];
            $ctrls.each(function() { this.checked = vals.includes(this.value); });
        } else if (tag === 'textarea' || ['text','password','email','number','hidden'].includes(type)) {
            $ctrls.val(value);
        } else if (type === 'file') {
            // file input 安全限制不可設置值,僅可清空
            $ctrls.val('');
        }
    });
}

3. TypeScript 類型定義


interface FormDataMap {
    [key: string]: string | string[] | number | boolean | File | FileList;
}

interface FormOperator {
    serialize(): FormDataMap;
    populate(data: FormDataMap): void;
    validate(): ValidationResult;
    reset(): void;
}

function createFormOperator($form: JQuery): FormOperator {
    return {
        serialize: () => serializeForm($form),
        populate: (data) => populateForm($form, data),
        validate: () => { /* 集成 validator.js 或 HTML5 驗證 */ },
        reset: () => $form[0].reset()
    };
}

三、Select 進階操作

1. 異步加載選項 (防抖搜索/無限滾動)


async function loadSelectOptions($sel, apiUrl, params = {}) {
    $sel.prop('disabled', true).empty().append('');
    try {
        const items = await $.getJSON(apiUrl, params);
        const html = items.map(item => 
            ``
        ).join('');
        $sel.empty().append(html).prop('disabled', false);
        // 觸發 change 以便監聽器響應
        $sel.trigger('change');
    } catch (e) {
        $sel.empty().append('').prop('disabled', false);
    }
}

2. 可搜索 Select (Select2/choices.js 替代輕量實現)


function makeSearchable($sel, options = {}) {
    const $wrapper = $('
'); const $input = $(''); const $options = $sel.find('option').clone(); $sel.hide().after($wrapper.append($input)).after($options); // 簡化版邏輯 // 生產環境強烈建議引入 Select2 / Choices.js / Tom Select }

四、Radio / Checkbox 分組操作

1. 獲取分組值 (單值/多值統一)


function getGroupValue($form, name) {
    const $radios = $form.find(`input[type="radio"][name="${CSS.escape(name)}"]`);
    const $checkboxes = $form.find(`input[type="checkbox"][name="${CSS.escape(name)}"]`);
    
    if ($radios.length) return $radios.filter(':checked').val() || null;
    if ($checkboxes.length) return $checkboxes.filter(':checked').map((_,el)=>el.value).get();
    return null;
}

2. 設置分組值


function setGroupValue($form, name, value) {
    const $radios = $form.find(`input[type="radio"][name="${CSS.escape(name)}"]`);
    const $checkboxes = $form.find(`input[type="checkbox"][name="${CSS.escape(name)}"]`);
    
    if ($radios.length) {
        $radios.filter(`[value="${CSS.escape(String(value))}"]`).prop('checked', true);
    } else if ($checkboxes.length) {
        const vals = Array.isArray(value) ? value.map(String) : [String(value)];
        $checkboxes.each(function() { this.checked = vals.includes(this.value); });
    }
}

五、驗證集成 (HTML5 原生 + 自定義)


function validateForm($form) {
    const nativeValid = $form[0].checkValidity();
    $form[0].reportValidity(); // 顯示瀏覽器原生提示
    return nativeValid;
}

// 自定義規則
$.validator?.addMethod('chineseName', (value) => /^[\u4e00-\u9fa5]{2,10}$/.test(value), '請輸入中文姓名');

六、無障礙 (a11y) 增強

  • <label for="id"> 關聯所有輸入框
  • 錯誤信息用 aria-describedby 關聯 role="alert" 元素
  • 必填項加 required + aria-required="true"
  • 動態更新選項時保持焦點管理

七、原文代碼遺留問題清單

原文代碼問題修正
select[@name=...]@ 選擇器已移除select[name=...]
option[@selected]同左option:selected
.attr('checked', true)屬性 vs 屬性混淆.prop('checked', true)
.attr('value', '')設置值應用 val().val('')
$('#select_id')[0].selectedIndex = 1混用原生屬性$sel.prop('selectedIndex', 1)
appendTo("#select") 字符串拼接XSS 風險、性能差.append(htmlString) 或構建 DOM

八、總結

  1. 核心口訣:值 .val(),狀態 .prop(),屬性 .attr(),選擇器無 @
  2. 統一封裝:serializeForm / populateForm / getGroupValue / setGroupValue 覆蓋 95% 場景
  3. 動態選項:.empty().append(htmlString) 批量構建,避免循環 append
  4. 驗證優先:HTML5 原生 checkValidity() + 自定義規則
  5. 複雜 Select:直接引入 Select2/Choices.js,勿重複造輪子

將這套工具函數封裝為 @/utils/formOps,表單頁開發從「拼湊選擇器」變為「調用語義化 API」,代碼可讀性、可維護性、可測試性全面提升。

copyright © 萬盛學電腦網 all rights reserved