DIV CSS 佈局教程網

EasyUI 開啟第二層彈出視窗:避免重複彈出的封裝寫法
編輯:JavaScript綜合知識     

在 dialog 裡再開一個 dialog(例如從列表按下「新增」跳出表單,表單中又要選其他資料),是後台系統很常見的結構。EasyUI 原生沒有現成方法,需要自己封裝一個,並處理好「重複點擊時不要疊出多個視窗」的問題。

封裝程式碼

$.modalDialogTwo = function (options) {
  if ($.modalDialogTwo.handler == undefined) {   // 關鍵:避免重複彈出
    var opts = $.extend({
      title  : '',
      width  : 840,
      height : 680,
      modal  : true,
      onClose: function () {
        $.modalDialogTwo.handler = undefined;     // 關閉後釋放句柄
        $(this).dialog('destroy');                // 徹底移除節點,避免記憶體累積
      },
      onOpen : function () {
        // parent.$.messager.progress({
        //   title: '提示', text: '數據加載中,請稍後....'
        // });
      }
    }, options);

    opts.modal = true;   // 強制為模式化視窗,無視傳入的 modal 參數

    return $.modalDialogTwo.handler = $('<div/>').dialog(opts);
  }
};

設計說明

$.modalDialogTwo.handler 是視窗的句柄。它同時充當「是否已開啟」的旗標:第一次呼叫時為 undefined,於是建立視窗並把回傳的 jQuery 物件存進去;後續再呼叫時因為 handler 已存在,整段 if 被跳過,不會再疊一個新視窗。這解決了使用者連點兩下「新增」就跳出兩個一模一樣表單的經典問題。

$.modalDialogTwo.xxx 可以自訂屬性。實務上最常用的是掛上「關閉後要刷新哪些元件」的資訊。因為視窗關閉時可以讀取這些屬性,決定要 reload 哪個 grid:

// 開啟時預告要刷新的目標
$.modalDialogTwo.reloadGrid = '#userGrid';
$.modalDialogTwo({ title: '編輯使用者', href: 'user/edit.do' });

// 關閉後
$('#userGrid').datagrid('reload');

這種「在函式物件上掛狀態」的寫法,本質上是用函式本身當命名空間,在沒有 ES Class 的時代很常見。

onClose 為什麼要 destroy 而不只是 hide

dialog('close') 只是隱藏元素,DOM 節點、已綁定的事件、內部的 iframe 都還在記憶體裡。若使用者反覆開關幾十次,記憶體與事件監聽器會持續累積,頁面越用越慢。

dialog('destroy') 會把節點從 DOM 中徹底移除。搭配把 handler 重設為 undefined,下次呼叫就能重新建立一個乾淨的視窗。這是「每開一次都是全新狀態」的正確做法。

使用上的提醒

第二層視窗的 modal 行為。強制 opts.modal = true 會讓第二層視窗遮罩住第一層。若業務上不希望使用者看到底層,這樣做很合適;但若希望使用者能對照底層資料填表,可考慮改用非模式化的 dialog,或把第二層做成同一視窗內的 panel 切換。

層層嵌套的深度上限。三層以上的彈出視窗會讓使用者迷失方向,也讓關閉後的刷新鏈難以追蹤。若真的需要三層,通常代表資訊架構該重新設計——把某一步驟改成獨立頁面或分頁會更清楚。

現代寫法對照。今天的專案若已不綁 EasyUI,用原生 <dialog> 元素搭配 showModal() 就能得到相同的「單一實例+強制關閉+釋放資源」效果,而且沒有相依性:

let dlg = null;
function openDialog(title, url) {
  if (dlg) return;
  dlg = document.getElementById('myDialog');
  dlg.showModal();
  dlg.addEventListener('close', () => { dlg.close(); dlg = null; }, { once: true });
}
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved