DIV CSS 佈局教程網

jQuery Tools Tab 標籤頁完整用法與參數、API 對照
編輯:JQuery特效代碼     

jQuery Tools 的 tabs 元件把「頁籤」與「面板」拆成兩個容器,再用一行 JavaScript 把兩者關聯起來,寫法直覺、擴充性也夠。以下從官方範例出發,整理 HTML、CSS 到所有可調參數與 API。

一、HTML 結構:頁籤清單 + 面板容器

<ul id="tabui" class="cs-tabs">
  <li><a id="t1" href="#tab1">Tab 1</a></li>
  <li><a id="t2" href="#tab2">Second tab</a></li>
  <li><a id="t3" href="#tab3">A ultra long third tab</a></li>
</ul>

<div id="tabpans" class="cs-panes">
  <div><p>第一個面板內容</p></div>
  <div><p>第二個面板內容</p></div>
  <div><p>第三個面板內容</p></div>
</div>

啟用方式只需要一行:

$(function() {
  // 頁面上只有一組 tabs 時,:first 可省略
  $(".cs-tabs:first").tabs(".cs-panes:first > div");
});

官方範例用的是 class 選取;如果偏好用 id,寫成 $("#tabui").tabs("#tabpans > div") 效果完全相同。若要明確指定事件與樣式類名,也可以帶入設定物件:

$("#tabui").tabs("#tabpans > div", {
  event:   'click',
  tab:     'p',
  effect:  'default',
  current: 'on'
});

二、CSS:頁籤外觀的關鍵幾段

/* 頁籤根元素 */
ul.cs-tabs {
  margin: 0 !important;
  padding: 0;
  height: 30px;
  border-bottom: 1px solid #666;
}
/* 單一頁籤 */
ul.cs-tabs li {
  float: left;
  padding: 0;
  margin: 0;
  list-style-type: none;
}
/* 頁籤內的連結 */
ul.cs-tabs a {
  float: left;
  font-size: 13px;
  display: block;
  padding: 5px 30px;
  text-decoration: none;
  border: 1px solid #666;
  border-bottom: 0;
  height: 18px;
  background-color: #efefef;
  color: #777;
  margin-right: 2px;
  position: relative;
  top: 1px;
  outline: 0;
  -moz-border-radius: 4px 4px 0 0;
}
ul.cs-tabs a:hover { background-color: #F7F7F7; color: #333; }
/* 目前選取的頁籤 */
ul.cs-tabs a.on {
  background-color: #ddd;
  border-bottom: 1px solid #ddd;
  color: #000;
  cursor: default;
}
/* 面板 */
.cs-panes div {
  display: none;
  border: 1px solid #666;
  border-width: 0 1px 1px 1px;
  min-height: 150px;
  padding: 15px 20px;
  background-color: #ddd;
}

三、設定參數

屬性預設值說明
current'current'目前作用中頁籤的 CSS 類名。
effect'default'切換頁籤時使用的效果,內建選項見下方。
event'click'觸發頁籤開啟的事件,也可用 mouseover、dblclick。
fadeInSpeed200搭配 fade 效果時,面板內容淡入的毫秒數(1.0.1 起)。
fadeOutSpeed0搭配 fade 效果時,面板內容淡出的毫秒數(1.1.0 起);大於 0 會形成 crossfade。
historyfalse是否支援瀏覽器上一頁/下一頁按鈕切換頁籤(1.2.0 起),需一併引入 history 工具。
initialIndex0頁面載入時預先開啟的頁籤索引;設為 null 或負數則全部收合。
rotatefalse搭配 next()/prev() 時是否循環輪播(1.1.0 起)。
tabs'a'用來選取頁籤元素的选择器,找不到時會退回根元素的直接子元素。

內建的五種效果分別是:

  • default:最單純的顯示/隱藏,也是預設行為。
  • fade:面板內容由透明漸增至完全顯示。
  • ajax:以 AJAX 從伺服器載入面板內容。
  • slide:垂直滑動,適合手風琴式導覽。
  • horizontal:水平滑動,適合橫向手風琴。

此外也允許自行定義效果。

四、事件

  • onBeforeClick:點擊頁籤之前觸發,第二個參數為被點擊頁籤的索引。
  • onClick:點擊之後觸發,第二個參數同樣是頁籤索引。

五、JavaScript API

var api = $("#tabui").data("tabs");
api.next();   // 前進到下一個頁籤
方法回傳說明
click(index)API啟用指定頁籤,參數可以是整數索引,也可以是帶 href 的頁籤元素或字串。
destroy()API徹底移除既有的 tabs 實例(1.2.3 起)。
getConf()Object取得設定物件,修改後會即時反映到行為上(1.0.1 起)。
getCurrentPane()jQuery取得目前面板。
getCurrentTab()jQuery取得目前頁籤。
getIndex()integer取得目前頁籤索引。
getPanes()jQuery取得所有面板。
getTabs()jQuery取得所有頁籤。
next() / prev()API前往下一個/上一個頁籤。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved