DIV CSS 佈局教程網

jQuery EasyUI 的 Panel 面板元件:屬性、事件與方法全解
編輯:JQuery特效代碼     

所有預設值可透過 $.fn.panel.defaults 覆寫。

建立 Panel

1. 從標記建立

把 easyui-panel 類別加到 div 標籤上,是最省事的建立方式:

<div id="p" class="easyui-panel" title="My Panel"
     style="width:500px;height:150px;padding:10px;background:#fafafa;"
     iconCls="icon-save" closable="true"
     collapsible="true" minimizable="true" maximizable="true">
    <p>panel content.</p>
</div>

2. 以程式建立

需要動態決定外觀時,改用 panel 方法並傳入設定物件,同時可掛上右上角自訂工具列:

$('#p').panel({
    width: 500,
    height: 150,
    title: 'My Panel',
    tools: [{
        iconCls: 'icon-add',
        handler: function(){ alert('new'); }
    },{
        iconCls: 'icon-save',
        handler: function(){ alert('save'); }
    }]
});

移動與載入內容

$('#p').panel('move', { left: 100, top: 100 });

$('#p').panel({
    href: 'content_url.php',
    onLoad: function(){ alert('loaded successfully'); }
});

主要特性

名稱類型說明預設值
titlestring顯示於面板標題列的文字。null
iconClsstring標題列上 16x16 圖示的 CSS 類別。null
width / heightnumber面板的寬與高。auto
left / topnumber面板的座標位置。null
cls / headerCls / bodyClsstring分別為面板整體、標題列、內容區加上自訂 CSS 類別。null
styleobject自訂行內樣式。{}
fitboolean為 true 時面板尺寸自動適應父容器。false
borderboolean是否顯示邊框。true
doSizeboolean為 true 時建立階段即計算尺寸並參與版面配置。true
noheaderboolean為 true 時不建立標題列。false
contentstring面板內容區的文字。null
collapsible / minimizable / maximizable / closableboolean分別控制摺疊、最小化、最大化、關閉按鈕是否顯示。false
toolsarray自訂工具組,每個項目包含 iconCls 與 handler。[]
collapsed / minimized / maximized / closedboolean指定初始化時的狀態。false
hrefstring用來載入遠端資料並顯示於面板內的 URL。null
cacheboolean為 true 時快取 href 載入的內容。true
loadingMessagestring載入遠端資料期間顯示的提示文字。Loading…
extractorfunction自訂如何從 Ajax 回應中擷取內容並回傳。無

extractor 的典型應用是只取出 body 區段,避免整份頁面被塞進面板:

extractor: function(data){
    var pattern = /<body[^>]*>((.|[\n\r])*)<\/body>/im;
    var matches = pattern.exec(data);
    if (matches){
        return matches[1]; // 只取 body 內容
    } else {
        return data;
    }
}

事件

名稱參數說明
onLoadnone遠端資料載入完成時觸發。
onBeforeOpennone面板開啟前觸發,回傳 false 可中止開啟。
onOpennone面板開啟後觸發。
onBeforeClosenone面板關閉前觸發,回傳 false 可取消關閉。
onClosenone面板關閉後觸發。
onBeforeDestroynone銷毀前觸發,回傳 false 可取消銷毀。
onDestroynone銷毀後觸發。
onBeforeCollapse / onCollapsenone摺疊前/後觸發,前者回傳 false 可停止摺疊。
onBeforeExpand / onExpandnone展開前/後觸發,前者回傳 false 可停止展開。
onResizewidth, height尺寸變更後觸發,參數為新的外部寬高。
onMoveleft, top位置變更後觸發,參數為新的座標。
onMaximize / onRestore / onMinimizenone最大化、還原、最小化完成後觸發。

方法

名稱參數說明
optionsnone回傳目前的設定物件。
panel / header / bodynone分別回傳面板本體、標題列、內容區的 jQuery 物件。
setTitletitle設定標題文字。
openforceOpen開啟面板;forceOpen 為 true 時略過 onBeforeOpen。
closeforceClose關閉面板;forceClose 為 true 時略過 onBeforeClose。
destroyforceDestroy銷毀面板;forceDestroy 為 true 時略過 onBeforeDestroy。
refreshhref重新載入遠端資料。
resizeoptions調整尺寸並重新配置,可傳入 width、height、left、top。
moveoptions移動至新位置,可傳入 left、top。
maximize / minimize / restorenone最大化、最小化、還原為原始尺寸與位置。
collapse / expandanimate摺疊或展開內容區,animate 控制是否使用動畫。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved