表單欄位一多,前台逐個取值、後台逐個接收,寫起來又臭又長還容易漏。本文整理一套以「標籤屬性」為錨點的傳值機制:前台用自訂屬性標記要收集或要回填的控制項,後台只需反序列化一個 Dictionary,雙向綁定的程式碼量大幅縮減。
jQuery 沒有內建此方法,自行擴充一個 $.toJSONString():
$.extend({
// 將 json 物件轉換成字串
toJSONString: function (object) {
if (object == null) return;
var type = typeof object;
if ('object' == type) {
if (Array == object.constructor) type = 'array';
else if (RegExp == object.constructor) type = 'regexp';
else type = 'object';
}
switch (type) {
case 'undefined':
case 'unknown':
return;
case 'function':
case 'boolean':
case 'regexp':
return object.toString();
case 'number':
return isFinite(object) ? object.toString() : 'null';
case 'string':
return '"' + object.replace(/(\\|\")/g, "\\$1")
.replace(/\n|\r|\t/g, function () {
var a = arguments[0];
return (a == '\n') ? '\\n' : (a == '\r') ? '\\r' : (a == '\t') ? '\\t' : "";
}) + '"';
case 'object':
if (object === null) return 'null';
var results = [];
for (var property in object) {
var value = $.toJSONString(object[property]);
if (value !== undefined) {
results.push($.toJSONString(property) + ':' + value);
}
}
return '{' + results.join(',') + '}';
case 'array':
var results = [];
for (var i = 0; i < object.length; i++) {
var value = $.toJSONString(object[i]);
if (value !== undefined) results.push(value);
}
return '[' + results.join(',') + ']';
}
}
});
負責把要送往後台的前台控制項值收集成結構化物件。
var DataClass = {
create: function () {
return function () {
this.MyInit.apply(this, arguments); // arguments: url, operation, params
};
}
};
var MyDataPack = DataClass.create();
MyDataPack.prototype = {
// 初始化
MyInit: function (url, operation, params) {
this.data = new Object();
var bdata = new Object();
bdata.url = url; // 位址
bdata.operation = operation; // 操作
bdata.params = params; // 參數
this.data.BasicData = bdata;
},
// 新增任意資料,如 addValue("obj", "111")
addValue: function (p, obj) {
this.data[p] = obj;
},
// 取得所有標記控制項的值並寫入資料
getValueSetData: function (togName) {
var values = Object();
$("[subtag='" + togName + "']").each(function () {
if (this.localName == "input") {
if (this.type == "text" || this.type == "hidden") {
values[this.id] = this.value;
}
// 其他型別(checkbox、radio、file 等)可在此擴充
}
// 其他標籤(select、textarea)可在此擴充
});
this.data[togName] = values;
},
// 取值,如 getValue("BasicData")
getValue: function (p) {
return this.data[p];
},
// 取得或設定 url
getUrl: function (url) {
if (url) this.data.BasicData["url"] = url;
else return this.data.BasicData["url"];
},
// 輸出成字串
getJsonData: function () {
return $.toJSONString(this.data);
}
};
讀取後台回傳的值,依屬性標記填回對應控制項。
var MyDataBinder = {
// 綁定資料到控制項,data 為資料,Tag 為標記
Bind: function (data, Tag) {
var MJson = $.parseJSON(data);
// 只綁定有標記的標籤
$("[bindtag='" + Tag + "']").each(function () {
if (this.localName == "input") {
if (MJson[this.id]) {
$(this).attr("value", MJson[this.id]);
}
}
// 其他標籤型別可在此擴充
});
}
};
<table>
<tr>
<th>一</th><th>二</th><th>三</th>
</tr>
<tr>
<td><input type="text" id="inp_1" subtag="subtag" bindtag="bind" /></td>
<td><input type="text" id="inp_2" subtag="subtag" value="我只是測試一下下" /></td>
<td><input type="text" id="inp_3" subtag="subtag" bindtag="bind" /></td>
</tr>
</table>
// 建立容器,帶入 url、操作名與參數
var MyDataPack = new MyDataPack("Handler1.ashx", "CESHI", "");
MyDataPack.getValueSetData("subtag"); // 收集 subtag 標記的控制項
// 送到後台
$.post(MyDataPack.getUrl(), MyDataPack.getJsonData(), function (data) {
// 把後台回傳值綁定回 bind 標記的控制項
MyDataBinder.Bind(data, "bind");
});
public void ProcessRequest(HttpContext context)
{
context.Response.ContentType = "text/plain";
// 前台傳來的是 json 物件轉成的字串,整包作為一個參數
var values = context.Request.Form[0];
// 需引用 System.Web.Extensions.dll
JavaScriptSerializer _jsSerializer = new JavaScriptSerializer();
// 反序列化為 Dictionary
Dictionary<string, Dictionary<string, string>> dic =
_jsSerializer.Deserialize<Dictionary<string, Dictionary<string, string>>>(values);
// 直接取用,例如 id 為 inp_2 的控制項值
string inp_2 = dic["subtag"]["inp_2"];
// 回傳值給前台
Dictionary<string, string> dic2 = new Dictionary<string, string>();
dic2.Add("inp_1", "修改1"); // 只需對應控制項 id
dic2.Add("inp_2", "修改2");
dic2.Add("inp_3", "修改3");
context.Response.Write(_jsSerializer.Serialize(dic2));
}
這個設計在欄位眾多的表單上確實省事,但有幾點值得留意:
this.id 組 key,因此控制項一定要有 id,且 id 就是前後台之間的契約。欄位改名時後台也要跟著改。subtag、bindtag 是 HTML5 之前的寫法。現在一律建議改用 data-* 前綴,例如 data-subtag,並以 $("[data-subtag]") 選取。$("#form").serialize() 或 new FormData(form) 已經能解決大部分問題,不必自建容器。這套方案的價值在於「可宣告式標記 + 雙向綁定」,適合欄位極多且需回填的後台表單。.html() 而非 .val(),後台傳來的字串可能成為攻擊途徑。關於以 JSON 實現前後台傳值的概念是否清楚了?有問題歡迎留言討論。