DIV CSS 佈局教程網

EasyUI Dialog 對話框完整用法:屬性、工具列、按鈕與方法全解析
編輯:JQuery特效代碼     

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('取消')——後者並不是合法的方法名。

二、對應的 HTML 結構

對話框的內容就是一個普通的容器元素,一開始先用 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 私有的屬性

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 做強制焦點,就足以應付絕大多數後台彈窗需求。

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