DIV CSS 佈局教程網

如何取得表單控件的原始值:以 ExtJS 為例的變更追蹤實作
編輯:關於JavaScript     

表單送出前常需要知道「使用者到底改了哪些欄位」,才能只更新有變動的資料。這個範例的做法是:利用瀏覽器原生的 defaultValue / defaultChecked 屬性取出初始值,與目前值比對,有差異就記進一個 saveObject,沒差異就從中刪除;同時在欄位旁顯示原值供對照。

範例是針對 ExtJS 元件寫的,因此針對下拉、日期、枚舉等型別各自有不同的取值路徑。

程式碼

var saveObject = {};   // 保存有變更的欄位

/**
 * 記錄單一控件的變更狀態
 * @param obj  控件(原生 DOM 或 Ext 元件)
 * @param type select / check / rq / enum,其他視為一般文字欄位
 */
function saveThisData(obj, type) {
    var defaultValue, newValue, key, displayValue, defaultValueDisplayFont;

    switch (type) {
        case 'select':      // Ext 下拉框
            defaultValue = obj.originalValue.split(']')[0].substring(1);
            newValue = obj.value;
            key = obj.id;
            defaultValueDisplayFont = obj.container.dom.getElementsByTagName("font")[0];
            displayValue = obj.originalValue.substring(defaultValue.length + 2);
            break;

        case 'check':       // 核取方塊
            key = obj.name;
            defaultValueDisplayFont = obj.parentElement.getElementsByTagName("font")[0];
            defaultValue = obj.defaultChecked;
            displayValue = defaultValue ? '是' : '否';
            newValue = obj.checked ? 1 : 0;
            break;

        case 'rq':          // Ext 日期物件
            key = obj.name;
            defaultValueDisplayFont = obj.parentElement.parentElement.getElementsByTagName("font")[0];
            defaultValue = obj.defaultValue;
            newValue = obj.value;
            displayValue = defaultValue;
            break;

        case 'enum':        // Ext 枚舉下拉
            key = obj.id;
            defaultValue = obj.startValue;
            newValue = obj.value;
            displayValue = obj.originalValue;
            defaultValueDisplayFont = obj.container.dom.getElementsByTagName("font")[0];
            break;

        default:
            if (arguments[2] != null) {   // 年月控件
                var monthFieldid = obj.container.dom.id.split("_")[1];
                key = monthFieldid;
                defaultValue = Ext.getDom('sccjgzny').defaultValue;
                newValue = Ext.getDom('sccjgzny').value;
                displayValue = defaultValue.substring(0, 7).replace('-', '年') + '月';
                defaultValueDisplayFont = Epx.get(monthFieldid).container.dom.getElementsByTagName("font")[0];
            } else {
                key = obj.name;
                defaultValueDisplayFont = obj.parentElement.getElementsByTagName("font")[0];
                defaultValue = obj.defaultValue;
                newValue = obj.value;
                displayValue = defaultValue;
            }
            break;
    }

    saveObject[key] = newValue;

    if (defaultValue != newValue) {
        if (defaultValue == '' && type != 'check') {
            defaultValueDisplayFont.innerHTML = "\u00a0\u00a0\u00a0\u00a0";
        } else {
            defaultValueDisplayFont.innerHTML = displayValue;
        }
    } else {
        defaultValueDisplayFont.innerHTML = '';
        delete saveObject[key];        // 改回原值就移出待存清單
    }
}

效果如下圖,被修改過的欄位旁會顯示原始值:

這個做法的關鍵觀念

  • defaultValue / defaultChecked 是「HTML 中寫死的值」:使用者在頁面上改動後,value 會變,但 defaultValue 仍保留初始狀態。這是瀏覽器天生提供的「原始值」機制,比自己在 onload 時掃一遍存起來更省事。
  • delete 而非設為 0:改回原值的欄位要真正從待存物件中移除,後端才不會收到無意義的更新。
  • 鬆散比較 != 的風險:defaultValue != newValue 會做型別轉換,"1" 與 1 被視為相等——這裡剛好是我們想要的,但若欄位是 "01" 與 "1" 就會誤判,實務上建議明確規範要比的字串形式。

可以更好的地方

  • 用 getElementsByTagName("font") 定位提示文字很脆弱:一旦樣板結構調整就會失效。請改用專用的 <span class="origin"> 並以 data-field 關聯欄位。
  • ExtJS 已停止維護:新專案請改用 React、Vue 等框架的表單狀態管理,或至少用 form.elements 搭配 form.reset() 與自訂的 dirty 狀態追蹤。
  • 動態表單要記得清理:欄位被移除時也要把對應的 key 從 saveObject 刪掉,否則會送出已不存在的欄位。
  • 素食版做法:不依賴 ExtJS 時,可以在頁面載入後用 [].forEach.call(form.elements, el => el.dataset.initial = el.value) 記錄初始值,再以 input/change 事件比對,邏輯更單純。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved