後台最典型的需求就是「新增/檢視/修改/刪除」四件事,而 LigerUI 的 grid 加 ligerForm 加 ligerDialog 剛好能組出一套完整的編輯視窗。這篇把整個組裝過程分六步走一遍。
<link href="../lib/ligerUI/skins/Aqua/css/ligerui-all.css" rel="stylesheet" type="text/css" />
<script src="../lib/jquery/jquery-1.5.2.min.js" type="text/javascript"></script>
<script src="../lib/ligerUI/js/ligerui.min.js" type="text/javascript"></script>
<script src="../lib/ligerUI/js/plugins/ligerForm.js" type="text/javascript"></script>
<script src="../lib/ligerUI/js/plugins/ligerGrid.js" type="text/javascript"></script>
<script src="../lib/ligerUI/js/plugins/ligerDateEditor.js" type="text/javascript"></script>
<link href="../lib/css/common.css" rel="stylesheet" type="text/css" />
<script src="../lib/js/common.js" type="text/javascript"></script>
<script src="../lib/js/LG.js" type="text/javascript"></script>
<script src="../lib/jquery-validation/jquery.validate.min.js" type="text/javascript"></script>
<script src="../lib/jquery-validation/jquery.metadata.js" type="text/javascript"></script>
<script src="../lib/jquery-validation/messages_cn.js" type="text/javascript"></script>
<script src="../lib/js/ligerui.expand.js" type="text/javascript"></script>
順序有講究:jQuery 要在 ligerUI 之前,插件要在 ligerui.min.js 之後,驗證相關的檔案要在 form 初始化之前。
彈窗內容來自一個預設隱藏的 div,裡頭放一個空白的 form,稍後由 ligerForm 動態填充欄位:
<div id="Editdetail" style="display:none;">
<form id="EditForm" method="post"></form>
</div>
function toolbarBtnItemClick(item) {
switch (item.id) {
case "add":
addbill({}, true, '添加記錄', false);
break;
case "view":
var selected = grid.getSelected();
if (!selected) { LG.tip('請選擇行!'); return }
addbill(selected, false, '查看記錄', true);
break;
case "modify":
var selected = grid.getSelected();
if (!selected) { LG.tip('請選擇行!'); return }
addbill(selected, false, '修改記錄', false);
break;
case "delete":
jQuery.ligerDialog.confirm('確定刪除嗎?', function (confirm) {
if (confirm) { f_delete(); }
});
break;
}
}
新增、檢視、修改共用同一個 addbill(),靠三個旗標區分行為,這樣後續改版面只需改一處。
var detailWin = null, currentData = null, currentIsAddNew, currentIsView;
function addbill(data, isAddNew, t, isview) {
currentData = data;
currentIsAddNew = isAddNew;
currentIsView = isview;
if (detailWin) {
detailWin.set('title', t);
detailWin.show();
} else {
// 首次執行時初始化表單並開窗(見第五步)
}
if (!isAddNew) {
$("#ProtId2").val(currentData.ProductName);
$("#ProId1").val(currentData.ProductId);
$("#ForId2").val(currentData.FormatName);
$("#Foad1").val(currentData.FormatId);
$("#Appl").val(currentData.AppendBill);
$("#Bum").val(currentData.BoxNum);
$("#Maate").val(currentData.MadeDate);
$("#BottleNum").val(currentData.BottleNum);
// ...其餘欄位同理
}
}
把 detailWin 存在函式外的變數,第二次開窗就不必重建,直接 show 即可,這能省下可觀的初始化時間。
var mainform = $("#EditForm");
mainform.ligerForm({
inputWidth: 150,
fields: [
{ name: "ProId1", type: "hidden" },
{ display: "倉庫", name: "Daihao1", newline: true, labelWidth: 100,
width: 150, space: 30, type: "text",
validate: { required: true, digits: true } },
{ display: "商品名稱", name: "ProId", comboboxName: "ProId2",
newline: false, labelWidth: 100, width: 150, space: 30,
type: "select", option: {} },
{ display: "單位", name: "DegreeId", comboboxName: "DegreeId2",
newline: false, labelWidth: 100, width: 150, space: 30,
type: "select",
options: { valueFieldID: "DegreeId1", treeLeafOnly: false,
tree: { url: "../handle/se1.ashx?ajaxaction=Getgree",
checkbox: false } } },
{ display: "生產日期", name: "MadeDate1", newline: true,
labelWidth: 100, width: 150, space: 30, type: "date",
validate: { required: true } },
{ display: "備注", name: "mark", newline: false, labelWidth: 100,
width: 150, space: 30, type: "text",
validate: { required: true, digits: true } }
],
toJSON: JSON2.stringify
});
$.metadata.setType("attr", "validate");
LG.validate(mainform, { debug: true });
$.ligerui.get("ProId2").set('onBeforeOpen', f_selectCoct);
$.ligerui.get("Faory2").set('onBeforeOpen', f_selectFary_1);
detailWin = $.ligerDialog.open({
target: $("#Editdetail"),
width: 595, height: 460, top: 80, title: "添加保存修改窗口",
buttons: [
{ text: '保存', onclick: function () { save(); } },
{ text: '取消', onclick: function () { detailWin.hide(); } }
]
});
幾個設計意圖值得說明:成對出現的 ProId1(hidden)與 ProId2(可見 select)是典型的「存 id、顯示名稱」模式,前者給後端用、後者給使用者看。onBeforeOpen 掛的是彈出選擇框的函式,讓下拉選單在被展開前才去載入選項,避免頁面初次載入就發出一堆請求。
save() 裡的順序建議是:先 mainform.valid() 驗證,通過後用 JSON2.stringify(form) 序列化,POST 到後端,成功再 detailWin.hide() 並 f_reload() 刷新表格。失敗則留在視窗裡讓使用者改,不要關掉。
範例中的 currentIsView 旗標就是為此準備的。在回寫資料之後加一段:
if (currentIsView) {
$("#EditForm input, #EditForm select").attr("disabled", true);
detailWin.buttons[0].set('text', '關閉');
}
直接用 disabled 會讓表單值無法送出,所以檢視模式下應該只讀而非禁用,或改用 LigerUI 的 API 逐欄設定唯讀。
欄位多的時候,把 fields 定義抽到獨立設定檔、把回寫邏輯改成迴圈(搭配欄位名稱對照表),程式碼量能少一半以上。另外 LigerUI 最後一次正式更新已有一段時間,新專案選型時值得評估維護狀況。