新增頁與編輯頁的差別,往往只在「表單渲染完要不要把既有資料填進去」。把這件事做成一個統一的 InitFormData 方法,兩種頁面就能共用同一套表單配置。
把一份 JSON 格式的 model 綁定到已渲染的表單上。實際環境中這份 model 來自伺服器請求,範例中則用寫死的物件模擬。
原始碼:https://github.com/xiexingen/Bootstrap-SmartForm/blob/master/demo/form4-initData.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>數據綁定</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="../css/bootstrap.css">
<link rel="stylesheet" href="../css/site.css">
<script src="../lib/jquery.js"></script>
<script src="../lib/bootstrap.js"></script>
<script src="../scripts/global.js"></script>
<script src="../scripts/plugin.js"></script>
</head>
<body>
<div class="panel panel-default">
<div class="panel-heading">
<label>數據綁定</label>
<div class="pull-right">
<button id="btnSubmit" class="btn btn-primary btn-xs">提交表單</button>
</div>
</div>
<div class="panel-body">
<form action="#" id="formContainer" class="form form-horizontal"></form>
</div>
</div>>
<script>
$(function () {
var eles = [
[
{ label: { text: '自定義用戶名:' },
ele: { type: 'text', name: 'UserName', title: '用戶名:', required: true } },
{ ele: { type: 'radio', name: 'sex', title: '性別:',
items: [{ text: '男', value: 1 }, { text: '女', value: 2 }] } },
{ ele: { type: 'checkbox', name: 'plant', title: '使用平台:',
items: [{ text: 'APP', value: 'app' }, { text: 'web', value: 'web' }] } }
],
[
{ ele: { type: 'select', name: 'province', title: '省份:', withNull: true,
items: [{ text: '廣東', value: 'GD' }, { text: '湖南', value: 'HN' }] } },
{ ele: { pre: { text: '<input type="radio">' },
type: 'text', name: 'displayName', title: '顯示名稱:' } },
{ ele: { type: 'search', title: '產品', id: 'ProductName' } }
],
[
{ ele: { type: 'datetime', name: 'FromeDate', title: '有效期:' } },
{ ele: { type: 'datetime', name: 'ToDate', title: '~' } }
]
];
var hides = [{ id: 'primaryKey' }];
var bsForm = new BSForm({
eles: eles,
hides: hides,
autoLayout: '1,3'
}).Render('formContainer', function (bf) {
// 實務上這份 model 應由伺服器提供
var model = {
primaryKey: 1,
UserName: 'xxg',
sex: 1,
plant: ['app', 'web'],
province: 'GD',
displayName: 'TEST',
ProductName: '筆記本',
FromeDate: '2015-06-10',
ToDate: '2015-08-08'
};
bf.InitFormData(model);
});
$("#btnSubmit").bind('click', function () {
var postData = bsForm.GetFormData();
alert("獲取到的表單數據為:" + JSON.stringify(postData));
});
});
</script>
</body>
</html>
Render() 的第二個參數是一個回呼,在表單 DOM 建立完成後執行。這個設計讓我們能在同一個位置完成所有「渲染後才能做」的初始化工作:綁定資料、掛上日期插件、設定驗證規則、依權限停用某些欄位。若少了這個回呼,這些工作只能散落在外部,容易出現時序錯誤。
一、多選欄位的資料型別。範例中 plant 的值是陣列 ['app', 'web'],這點必須注意。若後端回傳的是逗號分隔字串 "app,web",回填時不會有任何勾選,而且不會報錯——這種「靜默失敗」很難察覺。資料層與表單層之間的型別轉換要明確處理。
二、單選與下拉的值比對。這類欄位靠 value 比對來決定選中項,因此 model 中的值型別必須與 items 中設定的 value 型別一致。若 items 寫 value: 1(數字)而 model 給 "1"(字串),用 === 比對就會失敗。實務上建議統一用字串作為 value,避開這個類別的問題。
三、日期格式。datetime 型別欄位通常有指定格式(如 yyyy-MM-dd),而後端可能回傳 ISO 8601 含時區的完整格式。回填前需先格式化,否則插件無法解析,欄位會顯示空白。
四、找不到對應欄位時的行為。若 model 中有某個鍵但表單沒有對應欄位(或反之),理想行為是記錄警告而非靜默略過。資料對不上的問題若在開發階段就被大聲喊出來,能省下大量上線後的排查時間。

有了這套綁定機制,新增頁只是「不呼叫 InitFormData」或傳入空物件的特例。頁面模板、欄位配置、驗證規則、提交邏輯全部共用,只在進入時決定要不要載入既有資料。這是配置驅動表單最直接的收益:一個頁面元件服務兩種場景,維護成本減半。