ajaxOptions:當選項卡加載內容時添加一個 ajax 選項,只有在 ajax 模式下才生效,預設為 null。初始化設置示例(以下 .selector 均指 tabs 元素):
$('.selector').tabs({ ajaxOptions: { async: false } }); //把異步改為同步
//getter
var ajaxOptions = $('.selector').tabs('option', 'ajaxOptions');
//setter
$('.selector').tabs('option', 'ajaxOptions', { async: false });
cache:預設 false(無緩存)。用於 ajax 調用:無緩存表示每次都刷新,有緩存則首次請求後不再刷新。
$('.selector').tabs({ cache: true });
collapsible:預設 false,不可折疊。設為 true 時,再次點擊已選中的選項卡可將內容收起,再點一次又展開。
$('.selector').tabs({ collapsible: true });
cookie:預設 null,需 cookie 插件,用來保存最後一次選擇的選項卡。可設置 { expires: 7, path: '/', domain: 'jquery.com', secure: true }。
$('.selector').tabs({ cookie: { expires: 30 } });
deselectable:預設 false,作用與 collapsible 類似。
disabled:設置哪些選項卡不可用,是一個數組如 [0,1,2],預設為 []。
$('.selector').tabs({ disabled: [1, 2] });
event:切換選項卡的事件,預設 'click'。
$('.selector').tabs({ event: 'mouseover' }); //鼠標滑過切換
fx:切換時的動畫效果,預設 null(無動畫)。
idPrefix:使用 ajax 時為其添加唯一 id 的前綴,預設 'ui-tabs-'。
$('.selector').tabs({ idPrefix: 'ui-tabs-primary' });
selected:初始化時哪個選項卡被選中,預設 0(第一個)。
$('.selector').tabs({ selected: 3 });
spinner:遠程內容(ajax)加載時,顯示在選項卡標題上的加載提示 HTML。
$('.selector').tabs({ spinner: 'Retrieving data...' });
panelTemplate 與 tabTemplate:分別用於定製面板與標籤的 HTML 模板。
先給出一個事件綁定示例:
$('#example').bind('tabsselect', function(event, ui) {
ui.tab //被選中(點擊後)的選項卡元素
ui.panel //包含被選中選項卡內容的元素
ui.index //被選中選項卡的索引值(從 0 開始)
});
select(tabsselect):點擊選項卡時觸發。
$('.selector').tabs({
select: function(event, ui) { ... }
});
$('.selector').bind('tabsselect', function(event, ui) { ... });
load(tabsload):一個遠程(ajax)選項卡內容加載完成後觸發。
show(tabsshow):選項卡顯示後觸發。
add(tabsadd):添加選項卡後觸發。
remove(tabsremove):刪除選項卡後觸發。
enable(tabsenable):選項卡變為可用時觸發。
disable(tabsdisable):選項卡變為不可用時觸發。
.tabs('destroy') //銷毀
.tabs('disable') //整個選項卡組不可用
.tabs('enable') //整個選項卡組可用
.tabs('option', optionName, [value]) //設置屬性
.tabs('add', url, label, [index]) //添加選項卡
.tabs('remove', index) //刪除選項卡
.tabs('enable', index) //設置某個標籤可用
.tabs('disable', index) //設置某個標籤不可用
.tabs('select', index) //選擇某個標籤,index 從 0 開始
.tabs('load', index) //重載某個 ajax 選項卡內容
.tabs('url', index, url) //改變某個 ajax 選項卡將要加載的 url
.tabs('abort') //中止所有運行中的 ajax 請求或動畫
.tabs('rotate', ms, [continue]) //自動翻滾標籤,ms 為間隔毫秒,設 0 或 null 停止
4.1 獲取已選中選項卡的索引:
var $tabs = $('#example').tabs();
var selected = $tabs.tabs('option', 'selected'); // => 0
4.2 用其他元素代替選項卡點擊來切換:
var $tabs = $('#example').tabs();
$('#my-text-link').click(function() {
$tabs.tabs('select', 2); //切換到第三個標籤
return false;
});
4.3 添加選項卡後立刻選中它:
var $tabs = $('#example').tabs({
add: function(event, ui) {
$tabs.tabs('select', '#' + ui.panel.id);
}
});
4.4 在新窗口中打開選項卡:
$('#example').tabs({
select: function(event, ui) {
location.href = $.data(ui.tab, 'load.tabs');
return false;
}
});