DIV CSS 佈局教程網

jQuery EasyUI 的 Tabs 標籤頁元件:屬性、事件、方法與 Tab Panel 設定
編輯:JQuery特效代碼     

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

相依元件:panel、linkbutton

建立 Tabs

1. 從標記建立

只要為容器加上 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>

2. 以程式建立並攔截事件

$('#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 / heightnumberTabs 容器的寬與高。auto
plainboolean為 true 時不使用背景容器圖呈現頁籤條,外觀更簡潔。false
fitboolean為 true 時容器尺寸自動適應父元素。false
borderboolean是否顯示容器邊框。true
scrollIncrementnumber每按一次捲動按鈕所移動的像素數。100
scrollDurationnumber每次捲動動畫持續的毫秒數。400
toolsarray右側工具列,每個項目的設定方式與 linkbutton 相同。null

事件

名稱參數說明
onLoadpanel某個 Ajax 頁籤完成遠端資料載入時觸發。
onSelecttitle使用者切換到某頁籤時觸發。
onBeforeClosetitle關閉前觸發,回傳 false 可取消關閉。
onClosetitle頁籤關閉後觸發。
onAddtitle新增頁籤後觸發。
onUpdatetitle頁籤內容更新後觸發。
onContextMenue, title在頁籤上按右鍵時觸發,常用於自訂右鍵選單。

方法

名稱參數說明
optionsnone回傳 tabs 的設定物件。
tabsnone回傳所有頁籤。
resizenone重新計算容器尺寸並配置版面。
addoptions新增頁籤,參數為頁籤設定物件。
closetitle關閉指定標題的頁籤。
getTabtitle取得指定頁籤。
getSelectednone取得目前選取的頁籤。
selecttitle切換到指定頁籤。
existstitle判斷指定頁籤是否存在。
updateparam更新頁籤,param 包含 tab(目標頁籤)與 options(新的 panel 設定)。

Tab Panel 的常用屬性

頁籤內容其實就是一個 Panel,因此沿用 panel 的屬性設定。最常用到的包括:

名稱類型說明
titlestring頁籤標題文字。
contentstring頁籤內容。
hrefstring以遠端內容填充頁籤的 URL。
cacheboolean為 true 且 href 有效時快取該頁籤內容。
iconClsstring顯示於標題上的圖示 CSS 類別。
width / heightnumber頁籤內容區的尺寸,預設 auto。
closableboolean為 true 時顯示關閉按鈕。
selectedboolean為 true 時該頁籤在初始化即被選取。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved