幾乎每個後台系統都會遇到同一個問題:表單負責收集使用者輸入,JSON 負責和伺服器溝通,兩者之間需要一套可靠的轉換邏輯。本文用原生 JavaScript 實作兩個核心函式——把 JSON 物件寫回表單,以及把表單內容序列化成 JSON——並額外處理「物件內含集合」與「物件引用其他物件」這兩種巢狀情境。
整套方案的支點在於欄位的 name。當 name 寫成 user.name,代表 JSON 中 user 物件的 name 屬性;寫成 users[0].name,則代表 users 陣列第 0 個元素的 name。約定好這套命名規則後,剩下的就是字串解析加遞迴:把扁平的一維欄位還原成多層結構,或反過來把多層結構攤平成欄位。
先走訪 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:
// 這些型別不需要回填
}
}
}
}
反向操作時有幾個細節值得注意。多選下拉選單會先收集成陣列;核取方塊與單選鈕未勾選時直接跳過,勾選時則沿用 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;
}
這個函式負責把「父物件.子屬性」寫進 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;
}
}
}
它是 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];
}
}
}
a.b 表物件、a[0].b 表集合。FormData、JSON.stringify() 或成熟框架的表單模組,並記得對使用者輸入做驗證與跳脫。