在 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 的時代很常見。
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 });
}