需要引入的檔案:easyui.css、icon.css、jquery-1.4.2.min.js、jquery.easyui.min.js。
HTML 結構很直觀——一個容器 div,裡面每個子 div 就是一個面板,用 title 屬性指定標籤文字:
<div id="tt" style="width:500px;height:250px;">
<div title="Tab1" style="padding:20px;display:none;">
tab1
</div>
<div title="Tab2" closable="true" style="overflow:auto;padding:20px;display:none;">
tab2
</div>
<div title="Tab3" icon="icon-reload" closable="true" style="padding:20px;display:none;">
tab3
</div>
</div>
注意每個面板都寫了 display:none——這是 EasyUI 的慣例,交由外掛自行管理顯示與隱藏。
jQuery 部分:
// 建立標籤容器
$('#tt').tabs(options);
// 動態增加一個面板
$('#tt').tabs('add',{
title: 'New Tab',
content: 'Tab Body',
closable: true
});
| 名稱 | 型別 | 說明 | 預設值 |
|---|---|---|---|
| width | number | 標籤容器寬度 | auto |
| height | number | 標籤容器高度 | auto |
| idSeed | number | 產生標籤面板時使用的基本 id | 0 |
| plain | boolean | true 時標籤欄顯示為背景樣式 | false |
| fit | boolean | true 時自適應父容器大小 | false |
| border | boolean | 是否顯示容器邊框 | true |
| scrollIncrement | number | 按下捲動鈕時捲動的像素數 | 100 |
| scrollDuration | number | 捲動動畫持續的毫秒數 | 400 |
| 名稱 | 參數 | 說明 |
|---|---|---|
| onLoad | arguments | ajax 面板載入完畢後觸發,參數用法與 jQuery.ajax 相同 |
| onSelect | title | 選中某個標籤面板時觸發 |
| onClose | title | 關閉某個標籤面板時觸發 |
| 名稱 | 參數 | 說明 |
|---|---|---|
| resize | none | 重新調整容器佈局 |
| add | options | 新增一個標籤面板,參數為設定物件,欄位見下表 |
| close | title | 關閉標題為該值的面板 |
| select | title | 選中標題為該值的面板 |
| exists | title | 判斷該面板是否存在 |
| 名稱 | 型別 | 說明 | 預設值 |
|---|---|---|---|
| id | string | 面板 id | null |
| title | string | 面板標題 | — |
| content | string | 面板內容 | — |
| href | string | 從遠端載入資料的位址 | null |
| cache | boolean | true 時快取面板內容 | true |
| icon | string | 標題上圖示的 CSS class | null |
| closable | boolean | true 時標題上顯示關閉鈕 | false |
| selected | boolean | true 時該面板為預設顯示的那一個 | false |
| width | number | 面板寬度 | auto |
| height | number | 面板高度 | auto |
實務上有兩個地方值得留意。第一,href 搭配 cache:false 可以做到「每次切換都重新抓資料」,適合內容會變動的情境;反之若內容固定,保留 cache 預設值能省下不少請求。第二,selected 若同時有多個面板設為 true,實際生效的只有一個,因此動態產生面板時要自己確保唯一性。
以上翻譯難免有欠精確之處,若有錯誤歡迎指正。