DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> JSON基礎
JavaScript 表單域與 JSON 數據雙向互轉的完整實作
編輯:JSON基礎     

幾乎每個後台系統都會遇到同一個問題:表單負責收集使用者輸入,JSON 負責和伺服器溝通,兩者之間需要一套可靠的轉換邏輯。本文用原生 JavaScript 實作兩個核心函式——把 JSON 物件寫回表單,以及把表單內容序列化成 JSON——並額外處理「物件內含集合」與「物件引用其他物件」這兩種巢狀情境。

設計關鍵:用 name 屬性表達層級

整套方案的支點在於欄位的 name。當 name 寫成 user.name,代表 JSON 中 user 物件的 name 屬性;寫成 users[0].name,則代表 users 陣列第 0 個元素的 name。約定好這套命名規則後,剩下的就是字串解析加遞迴:把扁平的一維欄位還原成多層結構,或反過來把多層結構攤平成欄位。

一、把 JSON 資料填入表單

先走訪 form.elements,遇到含點號的 name 就交給遞迴函式取值,其餘直接對應同名屬性。取值成功後,再依欄位型別分派:核取方塊與單選鈕比對 value 後設定 checked,文字類欄位直接指派 value,下拉選單則遍歷 options 找出符合項。

/**
 * 將 JSON 物件的值設定到表單域中
 */
function jsonObjectToForm(form, jsonObject) {
    for (var i = 0, max = form.elements.length; i < max; i++) {
        var e = form.elements[i];
        var eName = e.name;
        var eValue;
        if (eName.indexOf('.') > 0) {
            var dotIndex = eName.indexOf('.');
            var parentName = eName.substring(0, dotIndex);
            var childName = eName.substring(dotIndex + 1);
            // 迭代判斷 eName,取出對應的 JSON 值
            eValue = iterValueFromJsonObject(jsonObject, parentName, childName);
        } else {
            eValue = jsonObject[eName];
        }

        if (eValue && eValue != "undefined" && eValue != "null") {
            switch (e.type) {
                case 'checkbox':
                case 'radio':
                    if (e.value == eValue) { e.checked = true; }
                    break;
                case 'hidden':
                case 'password':
                case 'textarea':
                case 'text':
                    e.value = eValue;
                    break;
                case 'select-one':
                case 'select-multiple':
                    for (var j = 0; j < e.options.length; j++) {
                        var op = e.options[j];
                        if (op.value == eValue) { op.selected = true; }
                    }
                    break;
                case 'button':
                case 'file':
                case 'image':
                case 'reset':
                case 'submit':
                default:
                    // 這些型別不需要回填
            }
        }
    }
}

二、把表單轉為 JSON 物件

反向操作時有幾個細節值得注意。多選下拉選單會先收集成陣列;核取方塊與單選鈕未勾選時直接跳過,勾選時則沿用 value;文字內容會先跳脫雙引號與反斜線,避免破壞後續的字串結構。

/**
 * JSON 陣列有兩種存取寫法:
 * 1. a.bs[0].id
 * 2. a["bs"][0]["id"]
 * 把表單轉換成 JSON 資料格式
 */
function formToJsonObject(form) {
    var jsonObject = {};
    for (var i = 0, max = form.elements.length; i < max; i++) {
        var e = form.elements[i];
        var em = [];
        if (e.type == 'select-multiple') {
            for (var j = 0; j < e.options.length; j++) {
                var op = e.options[j];
                if (op.selected) { em[em.length] = op.value; }
            }
        }

        switch (e.type) {
            case 'checkbox':
            case 'radio':
                if (!e.checked) { break; }
                // 故意不加 break,勾選時沿用下方文字欄位的處理
            case 'hidden':
            case 'password':
            case 'select-one':
            case 'select-multiple':
            case 'textarea':
            case 'text':
                var eName = e.name;
                var eValue;
                if (e.type == 'select-multiple') {
                    eValue = em;
                } else {
                    eValue = e.value.replace(new RegExp('(["\\])', 'g'), '\\$1');
                }
                // 判斷是否為物件類型資料
                if (eName.indexOf('.') > 0) {
                    var dotIndex = eName.indexOf('.');
                    var parentName = eName.substring(0, dotIndex);
                    var childName = eName.substring(dotIndex + 1);
                    iterJsonObject(jsonObject, parentName, childName, eValue);
                } else {
                    jsonObject[eName] = eValue;
                }
                break;
            case 'button':
            case 'file':
            case 'image':
            case 'reset':
            case 'submit':
            default:
        }
    }
    return jsonObject;
}

三、遞迴組裝:iterJsonObject

這個函式負責把「父物件.子屬性」寫進 JSON 結構。它會先檢查父名稱中是否含 [:沒有中括號就當成純物件屬性,逐層建立空物件;有中括號則解析出集合名稱與下標,必要時初始化陣列,再往指定下標塞入物件。

/**
 * 把表單元素迭代轉換成 JSON 資料
 */
function iterJsonObject(jsonObject, parentName, childName, eValue) {
    // pArrayIndex 用於判斷元素是否為陣列標示
    var pArrayIndex = parentName.indexOf('[');
    if (pArrayIndex < 0) {
        // 不是集合,只是單純的物件屬性
        var child = jsonObject[parentName];
        if (!child) { jsonObject[parentName] = {}; }
        var dotIndex = childName.indexOf('.');
        if (dotIndex > 0) {
            iterJsonObject(jsonObject[parentName],
                childName.substring(0, dotIndex),
                childName.substring(dotIndex + 1), eValue);
        } else {
            jsonObject[parentName][childName] = eValue;
        }
    } else {
        var pArray = jsonObject[parentName.substring(0, pArrayIndex)];
        // 若不存在陣列,則初始化一個
        if (!pArray) {
            jsonObject[parentName.substring(0, pArrayIndex)] = [];
        }
        // 取得集合下標,並判斷對應下標是否已有物件
        var arrayIndex = parentName.substring(pArrayIndex + 1, parentName.length - 1);
        var c = jsonObject[parentName.substring(0, pArrayIndex)][arrayIndex];
        if (!c) {
            jsonObject[parentName.substring(0, pArrayIndex)][arrayIndex] = {};
        }
        var dotIndex = childName.indexOf('.');
        if (dotIndex > 0) {
            iterJsonObject(
                jsonObject[parentName.substring(0, pArrayIndex)][arrayIndex],
                childName.substring(0, dotIndex),
                childName.substring(dotIndex + 1), eValue);
        } else {
            jsonObject[parentName.substring(0, pArrayIndex)][arrayIndex][childName] = eValue;
        }
    }
}

四、遞迴取值:iterValueFromJsonObject

它是 iterJsonObject 的鏡像操作,同樣先判斷有沒有中括號,再逐層往下取,最後回傳最末端的屬性值。

/**
 * 迭代從 JSON 物件中取值,設定到表單域
 */
function iterValueFromJsonObject(jsonObject, parentName, childName) {
    var pArrayIndex = parentName.indexOf('[');
    if (pArrayIndex < 0) {
        var dotIndex = childName.indexOf('.');
        if (dotIndex > 0) {
            return iterValueFromJsonObject(jsonObject[parentName],
                childName.substring(0, dotIndex),
                childName.substring(dotIndex + 1));
        } else {
            return jsonObject[parentName][childName];
        }
    } else {
        var arrayIndex = parentName.substring(pArrayIndex + 1, parentName.length - 1);
        var dotIndex = childName.indexOf('.');
        if (dotIndex > 0) {
            return iterValueFromJsonObject(
                jsonObject[parentName.substring(0, pArrayIndex)][arrayIndex],
                childName.substring(0, dotIndex),
                childName.substring(dotIndex + 1));
        } else {
            return jsonObject[parentName.substring(0, pArrayIndex)][arrayIndex][childName];
        }
    }
}

重點回顧

  • name 的命名規範是整套機制的契約,a.b 表物件、a[0].b 表集合。
  • 回填與序列化各有一支遞迴函式,邏輯互為反操作。
  • 核取方塊、單選鈕、多選下拉需要各自特殊處理,不能一律用 value 指派。
  • 正式環境建議改用 FormData、JSON.stringify() 或成熟框架的表單模組,並記得對使用者輸入做驗證與跳脫。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved