預設值可透過 $.fn.tabs.defaults 覆寫。

相依元件:panel、linkbutton
只要為容器加上 easyui-tabs 類別,完全不必撰寫 JavaScript。每個頁籤都是容器下的子 div,其屬性用法與 Panel 相同:
<div id="tt" class="easyui-tabs" style="width:500px;height:250px;">
<div title="Tab1" style="padding:20px;">tab1</div>
<div title="Tab2" closable="true" style="padding:20px;">tab2</div>
<div title="Tab3" iconCls="icon-reload" closable="true" style="padding:20px;">tab3</div>
</div>
$('#tt').tabs({
border: false,
onSelect: function(title){
alert(title + ' is selected');
}
});
// 新增一個頁籤
$('#tt').tabs('add', {
title: 'New Tab',
content: 'Tab Body',
closable: true
});
// 取得目前選取的頁籤
var pp = $('#tt').tabs('getSelected');
var tab = pp.panel('options').tab; // 對應的 tab 物件
| 名稱 | 類型 | 說明 | 預設值 |
|---|---|---|---|
| width / height | number | Tabs 容器的寬與高。 | auto |
| plain | boolean | 為 true 時不使用背景容器圖呈現頁籤條,外觀更簡潔。 | false |
| fit | boolean | 為 true 時容器尺寸自動適應父元素。 | false |
| border | boolean | 是否顯示容器邊框。 | true |
| scrollIncrement | number | 每按一次捲動按鈕所移動的像素數。 | 100 |
| scrollDuration | number | 每次捲動動畫持續的毫秒數。 | 400 |
| tools | array | 右側工具列,每個項目的設定方式與 linkbutton 相同。 | null |
| 名稱 | 參數 | 說明 |
|---|---|---|
| onLoad | panel | 某個 Ajax 頁籤完成遠端資料載入時觸發。 |
| onSelect | title | 使用者切換到某頁籤時觸發。 |
| onBeforeClose | title | 關閉前觸發,回傳 false 可取消關閉。 |
| onClose | title | 頁籤關閉後觸發。 |
| onAdd | title | 新增頁籤後觸發。 |
| onUpdate | title | 頁籤內容更新後觸發。 |
| onContextMenu | e, title | 在頁籤上按右鍵時觸發,常用於自訂右鍵選單。 |
| 名稱 | 參數 | 說明 |
|---|---|---|
| options | none | 回傳 tabs 的設定物件。 |
| tabs | none | 回傳所有頁籤。 |
| resize | none | 重新計算容器尺寸並配置版面。 |
| add | options | 新增頁籤,參數為頁籤設定物件。 |
| close | title | 關閉指定標題的頁籤。 |
| getTab | title | 取得指定頁籤。 |
| getSelected | none | 取得目前選取的頁籤。 |
| select | title | 切換到指定頁籤。 |
| exists | title | 判斷指定頁籤是否存在。 |
| update | param | 更新頁籤,param 包含 tab(目標頁籤)與 options(新的 panel 設定)。 |
頁籤內容其實就是一個 Panel,因此沿用 panel 的屬性設定。最常用到的包括:
| 名稱 | 類型 | 說明 | |
|---|---|---|---|
| title | string | 頁籤標題文字。 | |
| content | string | 頁籤內容。 | |
| href | string | 以遠端內容填充頁籤的 URL。 | |
| cache | boolean | 為 true 且 href 有效時快取該頁籤內容。 | |
| iconCls | string | 顯示於標題上的圖示 CSS 類別。 | |
| width / height | number | 頁籤內容區的尺寸,預設 auto。 | |
| closable | boolean | 為 true 時顯示關閉按鈕。 | |
| selected | boolean | 為 true 時該頁籤在初始化即被選取。 |