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

把 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>
需要動態決定外觀時,改用 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'); }
});
| 名稱 | 類型 | 說明 | 預設值 |
|---|---|---|---|
| title | string | 顯示於面板標題列的文字。 | null |
| iconCls | string | 標題列上 16x16 圖示的 CSS 類別。 | null |
| width / height | number | 面板的寬與高。 | auto |
| left / top | number | 面板的座標位置。 | null |
| cls / headerCls / bodyCls | string | 分別為面板整體、標題列、內容區加上自訂 CSS 類別。 | null |
| style | object | 自訂行內樣式。 | {} |
| fit | boolean | 為 true 時面板尺寸自動適應父容器。 | false |
| border | boolean | 是否顯示邊框。 | true |
| doSize | boolean | 為 true 時建立階段即計算尺寸並參與版面配置。 | true |
| noheader | boolean | 為 true 時不建立標題列。 | false |
| content | string | 面板內容區的文字。 | null |
| collapsible / minimizable / maximizable / closable | boolean | 分別控制摺疊、最小化、最大化、關閉按鈕是否顯示。 | false |
| tools | array | 自訂工具組,每個項目包含 iconCls 與 handler。 | [] |
| collapsed / minimized / maximized / closed | boolean | 指定初始化時的狀態。 | false |
| href | string | 用來載入遠端資料並顯示於面板內的 URL。 | null |
| cache | boolean | 為 true 時快取 href 載入的內容。 | true |
| loadingMessage | string | 載入遠端資料期間顯示的提示文字。 | Loading… |
| extractor | function | 自訂如何從 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;
}
}
| 名稱 | 參數 | 說明 |
|---|---|---|
| onLoad | none | 遠端資料載入完成時觸發。 |
| onBeforeOpen | none | 面板開啟前觸發,回傳 false 可中止開啟。 |
| onOpen | none | 面板開啟後觸發。 |
| onBeforeClose | none | 面板關閉前觸發,回傳 false 可取消關閉。 |
| onClose | none | 面板關閉後觸發。 |
| onBeforeDestroy | none | 銷毀前觸發,回傳 false 可取消銷毀。 |
| onDestroy | none | 銷毀後觸發。 |
| onBeforeCollapse / onCollapse | none | 摺疊前/後觸發,前者回傳 false 可停止摺疊。 |
| onBeforeExpand / onExpand | none | 展開前/後觸發,前者回傳 false 可停止展開。 |
| onResize | width, height | 尺寸變更後觸發,參數為新的外部寬高。 |
| onMove | left, top | 位置變更後觸發,參數為新的座標。 |
| onMaximize / onRestore / onMinimize | none | 最大化、還原、最小化完成後觸發。 |
| 名稱 | 參數 | 說明 |
|---|---|---|
| options | none | 回傳目前的設定物件。 |
| panel / header / body | none | 分別回傳面板本體、標題列、內容區的 jQuery 物件。 |
| setTitle | title | 設定標題文字。 |
| open | forceOpen | 開啟面板;forceOpen 為 true 時略過 onBeforeOpen。 |
| close | forceClose | 關閉面板;forceClose 為 true 時略過 onBeforeClose。 |
| destroy | forceDestroy | 銷毀面板;forceDestroy 為 true 時略過 onBeforeDestroy。 |
| refresh | href | 重新載入遠端資料。 |
| resize | options | 調整尺寸並重新配置,可傳入 width、height、left、top。 |
| move | options | 移動至新位置,可傳入 left、top。 |
| maximize / minimize / restore | none | 最大化、最小化、還原為原始尺寸與位置。 |
| collapse / expand | animate | 摺疊或展開內容區,animate 控制是否使用動畫。 |