jQuery Tools 的 tabs 元件把「頁籤」與「面板」拆成兩個容器,再用一行 JavaScript 把兩者關聯起來,寫法直覺、擴充性也夠。以下從官方範例出發,整理 HTML、CSS 到所有可調參數與 API。
<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'
});
/* 頁籤根元素 */
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。 |
| fadeInSpeed | 200 | 搭配 fade 效果時,面板內容淡入的毫秒數(1.0.1 起)。 |
| fadeOutSpeed | 0 | 搭配 fade 效果時,面板內容淡出的毫秒數(1.1.0 起);大於 0 會形成 crossfade。 |
| history | false | 是否支援瀏覽器上一頁/下一頁按鈕切換頁籤(1.2.0 起),需一併引入 history 工具。 |
| initialIndex | 0 | 頁面載入時預先開啟的頁籤索引;設為 null 或負數則全部收合。 |
| rotate | false | 搭配 next()/prev() 時是否循環輪播(1.1.0 起)。 |
| tabs | 'a' | 用來選取頁籤元素的选择器,找不到時會退回根元素的直接子元素。 |
內建的五種效果分別是:
default:最單純的顯示/隱藏,也是預設行為。fade:面板內容由透明漸增至完全顯示。ajax:以 AJAX 從伺服器載入面板內容。slide:垂直滑動,適合手風琴式導覽。horizontal:水平滑動,適合橫向手風琴。此外也允許自行定義效果。
onBeforeClick:點擊頁籤之前觸發,第二個參數為被點擊頁籤的索引。onClick:點擊之後觸發,第二個參數同樣是頁籤索引。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 | 前往下一個/上一個頁籤。 |