DIV CSS 佈局教程網

Bootstrap 智能表單實戰:編輯頁的數據綁定與回填
編輯:關於JavaScript     

新增頁與編輯頁的差別,往往只在「表單渲染完要不要把既有資料填進去」。把這件事做成一個統一的 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」或傳入空物件的特例。頁面模板、欄位配置、驗證規則、提交邏輯全部共用,只在進入時決定要不要載入既有資料。這是配置驅動表單最直接的收益:一個頁面元件服務兩種場景,維護成本減半。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved