DIV CSS 佈局教程網

LigerUI 彈出編輯視窗實作:從載入、工具列到表單回寫
編輯:JavaScript綜合知識     

後台最典型的需求就是「新增/檢視/修改/刪除」四件事,而 LigerUI 的 grid 加 ligerForm 加 ligerDialog 剛好能組出一套完整的編輯視窗。這篇把整個組裝過程分六步走一遍。

一、載入必要的 CSS 與 JS

<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 初始化之前。

二、在 HTML 裡預留容器

彈窗內容來自一個預設隱藏的 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(),靠三個旗標區分行為,這樣後續改版面只需改一處。

四、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 最後一次正式更新已有一段時間,新專案選型時值得評估維護狀況。

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