萬盛學電腦網

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

jQuery 選擇器快速提取表單資料:自訂屬性 _postField 實現 JSON 序列化

痛點:傳統表單序列化的繁瑣

傳統做法需逐一 document.getElementById() 或 $('input[name=x]').val(),欄位一多極易遺漏、難維護。本文介紹一種約定優於配置的策略:在每個需提交的表單元素加上自訂屬性 _postField,統一由單一函式遍歷收集,自動組裝成 JSON 物件送往後端。

核心實作:getFormField()

/**
 * 依 _postField 屬性收集表單資料
 * @param {string} attrName - 自訂屬性名,預設 "_postField"
 * @returns {Object} key-value 物件,key=_postField 值,value=元素值
 */
function getFormField(attrName) {
    attrName = attrName || '_postField';
    var $fields = $('[' + attrName + ']'); // 選取所有擁有此屬性的元素
    var data = {};

    $fields.each(function() {
        var $el = $(this);
        var key = $el.attr(attrName);
        var tag = this.tagName.toLowerCase();
        var type = this.type ? this.type.toLowerCase() : '';
        var val;

        switch (tag) {
            case 'input':
                if (type === 'radio' || type === 'checkbox') {
                    if (!this.checked) return; // 未勾選跳過
                    if (type === 'radio') {
                        data[key] = $el.val(); // 單選直接覆蓋
                    } else { // checkbox 多選合併為逗號字串
                        data[key] = (data[key] ? data[key] + ',' : '') + $el.val();
                    }
                } else { // text, hidden, password, email, number...
                    data[key] = $el.val();
                }
                break;

            case 'textarea':
                data[key] = $el.val();
                break;

            case 'select':
                data[key] = $el.val(); // jQuery val() 自動處理單/多選
                break;

            default:
                data[key] = $el.html(); // 其他元素取 innerHTML
        }
    });

    return data;
}

HTML 範例

<form id="myForm">
  <input type="text" _postField="username" placeholder="用戶名" /><br/>
  <input type="radio" name="gender" value="M" _postField="gender" />男
  <input type="radio" name="gender" value="F" _postField="gender" />女<br/>
  <input type="checkbox" value="js" _postField="skills" />JavaScript
  <input type="checkbox" value="css" _postField="skills" />CSS<br/>
  <select _postField="city">
    <option value="tp">台北</option>
    <option value="kc">高雄</option>
  </select><br/>
  <button type="button" onclick="submitForm()">送出</button>
</form>

送出邏輯

function submitForm() {
    var postData = getFormField('_postField');
    console.log('送出資料:', postData);
    // { username: "...", gender: "M", skills: "js,css", city: "tp" }

    $.ajax({
        url: '/api/submit',
        type: 'POST',
        dataType: 'json',
        data: postData,
        success: function(res) { alert('成功'); }
    });
}

優缺點分析

優點缺點/注意事項
零配置:新增欄位只需加 _postField 非標準屬性,HTML 驗證會警告(可改用 data-post-field)
自動處理 radio/checkbox/select 多樣型別 checkbox 合併為逗號字串,後端需自行分割
程式碼集中、易維護、易擴充 檔案上傳 需用 FormData,不適用此法
可搭配驗證庫(如 validate.js)共用選擇器 動態新增元素需重新掃描或用事件代理

現代化改良:使用 HTML5 data-* 屬性 + FormData

<input type="text" data-field="username" />

// 原生 FormData + 選擇器收集(支援檔案)
function collectFormData(formSel) {
    var form = document.querySelector(formSel);
    var fd = new FormData(form); // 自動包含所有 name 屬性欄位
    // 若需只收集 data-field 的欄位:
    var data = {};
    form.querySelectorAll('[data-field]').forEach(el => {
        var key = el.dataset.field;
        if (el.type === 'checkbox') {
            if (el.checked) data[key] = (data[key] ? data[key] + ',' : '') + el.value;
        } else if (el.type === 'radio') {
            if (el.checked) data[key] = el.value;
        } else {
            data[key] = el.value;
        }
    });
    return data;
}

總結

自訂屬性 _postField(或標準 data-field)配合 jQuery 選擇器遍歷,能以極少程式碼實現表單資料的自動化 JSON 序列化。核心邏輯在於統一入口、型別分派、多值合併三步驟。現代專案建議改用 FormData 搭配 data-* 屬性,同時支援檔案上傳並符合 HTML 標準。

copyright © 萬盛學電腦網 all rights reserved