EasyUI 的 Dialog(對話框)是後台系統裡最常被用到的元件之一。它本質上是一個建立在 Window 基礎上的浮動視窗,除了繼承 Window 的拖曳、關閉、置中行為之外,還額外提供了可折疊、可最小化、可最大化以及自訂工具列與底部按鈕的能力,非常適合拿來做「新增/編輯資料」這類表單彈窗。
先看一下實際跑出來的樣子:
下面的 JavaScript 在頁面點擊時把一個隱藏的 DIV 變成對話框,同時掛上工具列按鈕(添加、保存)與底部按鈕(提交、取消):
<script language="javascript" type="text/javascript">
function Open_Dialog() {
$('#mydialog').show();
$('#mydialog').dialog({
collapsible: true,
minimizable: true,
maximizable: true,
toolbar: [{
text: '添加',
iconCls: 'icon-add',
handler: function() { alert('添加數據') }
}, {
text: '保存',
iconCls: 'icon-save',
handler: function() { alert('保存數據') }
}],
buttons: [{
text: '提交',
iconCls: 'icon-ok',
handler: function() { alert('提交數據'); }
}, {
text: '取消',
handler: function() { $('#mydialog').dialog('close'); }
}]
});
}
</script>
這裡有兩個關鍵觀念要分清楚:toolbar 是畫在對話框標題欄上的小工具按鈕,而 buttons 則是排在最底部的操作區。取消按鈕要關閉視窗,正確的寫法是呼叫 $('#mydialog').dialog('close'),而不是 dialog('取消')——後者並不是合法的方法名。
對話框的內容就是一個普通的容器元素,一開始先用 display:none 藏起來,等呼叫 dialog() 之後再由 EasyUI 接管它的樣式與定位:
<span onclick="Open_Dialog()">彈框</span>
<div id="mydialog" style="display:none;padding:5px;width:400px;height:200px;" title="彈框練習">
<input id="txRoleID" type="hidden" value="0" />
<label class="lbInfo">角色名稱:</label>
<input id="txRolename" type="text" class="easyui-validatebox" required="true" /><br />
<input type="submit" value="保存" onclick="saveRole" />
<label id="lbmsg"></label>
</div>
值得留意的是 class="easyui-validatebox" 加上 required="true":只要欄位套上驗證 class,EasyUI 就會自動接管必填檢查,這比自己在 JS 裡逐一 if 判斷要乾淨得多。
Dialog 的大部分屬性其實和 Window 完全一樣(例如 width、height、modal、closed、draggable 等),真正屬於 Dialog 自己新增的只有下面這幾個:
| 屬性名 | 類型 | 說明 | 預設值 |
|---|---|---|---|
| title | 字串 | 對話框標題顯示的文字 | New Dialog |
| collapsible | 布林 | 是否顯示折疊(收起內容)按鈕 | false |
| minimizable | 布林 | 是否顯示最小化按鈕 | false |
| maximizable | 布林 | 是否顯示最大化按鈕 | false |
| resizable | 布林 | 是否允許使用者拖曳改變對話框尺寸 | false |
| toolbar | 陣列 | 標題欄上的工具列,每項可含 text、iconCls、disabled、handler 等 | null |
| buttons | 陣列 | 底部按鈕區,每項可含 text、iconCls、handler 等 | null |
事件方面,Dialog 直接沿用 Window 的這一整套:onOpen、onClose、onBeforeClose、onCollapse、onExpand、onMinimize、onMaximize、onRestore、onResize、onMove、onLoad 等,行為與觸發時機都相同,不需要另外記憶。
方法方面,除了 header 與 body 這兩個取用內部結構的方法之外,其餘都與 Window 一致。實務上最常使用的是:
// 開啟
$('#mydialog').dialog('open');
// 關閉
$('#mydialog').dialog('close');
// 銷毀(把 DOM 一起清掉)
$('#mydialog').dialog('destroy');
// 讀取/修改單一屬性
var t = $('#mydialog').dialog('options').title;
$('#mydialog').dialog({ title: '新的標題' });
// 置中
$('#mydialog').dialog('move', 'center');
// 調整尺寸
$('#mydialog').dialog('resize', { width: 600, height: 400 });
把 Dialog 用熟其實只要記住三件事:內容放進一個隱藏的容器、初始化時用 toolbar 與 buttons 描述操作區、之後一律透過 $(selector).dialog('方法名') 去控制。搭配 validatebox 做表單驗證、搭配 modal:true 做強制焦點,就足以應付絕大多數後台彈窗需求。