把 tabs 元件加上 slideshow 外掛,就能得到會自動播放、可前後翻頁、可點擊切換的幻燈片。以下用官方範例說明完整做法。
幻燈片由四塊組成:上一張按鈕、投影片容器、下一張按鈕,以及頁籤(小圓點)與播放控制。
<a class="backward">prev</a>
<div class="images">
<div><h3>First pane</h3><p>第一張投影片內容</p></div>
<div><h3>Second pane</h3><p>第二張投影片內容</p></div>
<div><h3>Third pane</h3><p>第三張投影片內容</p></div>
</div>
<a class="forward">next</a>
<div class="slidetabs">
<a href="#"></a>
<a href="#"></a>
<a href="#"></a>
</div>
<div style="clear:both;margin:30px 0 0;text-align:center;">
<button onClick='$(".slidetabs").data("slideshow").play();'>Play</button>
<button onClick='$(".slidetabs").data("slideshow").stop();'>Stop</button>
</div>
$(function() {
$(".slidetabs").tabs(".images > div", {
effect: 'fade', // 交錯淡入淡出
fadeOutSpeed: "slow",
rotate: true // 播到最後一張回到開頭
}).slideshow();
});
若想把前後頁按鈕一起綁進來,只需在設定中補上 next 與 prev 選擇器:
$(function() {
$(".slidetabs").tabs(".images > div", {
effect: 'fade',
fadeOutSpeed: "slow",
next: '.forward',
prev: '.backward',
rotate: true
}).slideshow();
});
/* 投影片容器 */
.images {
background: #fff repeat-x;
border: 1px solid #ccc;
position: relative;
height: 300px;
width: 560px;
float: left;
margin: 15px;
cursor: pointer;
-moz-border-radius: 5px;
-webkit-border-radius: 5px;
-moz-box-shadow: 0 0 25px #666;
-webkit-box-shadow: 0 0 25px #666;
}
/* 單張投影片以絕對定位堆疊 */
.images div {
display: none;
position: absolute;
top: 0;
left: 0;
margin: 7px;
padding: 15px 30px 15px 15px;
height: 256px;
font-size: 12px;
}
.images h3 {
font-size: 22px;
font-weight: normal;
margin: 0 0 20px 0;
color: #456;
}
/* 頁籤(幻燈片下方的小圓點) */
.slidetabs { clear: both; margin-left: 310px; }
.slidetabs a {
width: 8px; height: 8px;
float: left; margin: 3px;
background: url(./navigator.png) 0 0 no-repeat;
display: block; font-size: 1px;
}
.slidetabs a:hover { background-position: 0 -8px; }
.slidetabs a.current { background-position: 0 -16px; }
/* 前後頁按鈕,用同一張 sprite 切圖 */
.forward, .backward {
float: left;
margin-top: 140px;
background: #fff url(./hori_large.png) no-repeat;
display: block;
width: 30px; height: 30px;
cursor: pointer;
font-size: 1px;
text-indent: -9999em;
}
.forward { background-position: 0 -30px; clear: right; }
.forward:hover { background-position: -30px -30px; }
.forward:active { background-position: -60px -30px; }
.backward:hover { background-position: -30px 0; }
.backward:active { background-position: -60px 0; }
/* 未設定 rotate: true 時,用這個類名把到頭的按鈕藏起來 */
.disabled { visibility: hidden !important; }
示範用到的圖檔如下:


| 屬性 | 預設值 | 說明 |
|---|---|---|
| next | '.forward' | 「下一張」動作要綁定的元素選擇器。 |
| prev | '.backward' | 「上一張」動作要綁定的元素選擇器。 |
| disabledClass | 'disabled' | 套用在到頭的上一頁/下一頁元素上的 CSS 類名。 |
| autoplay | false | 設為 true 時會自動前進,通常需要搭配 tabs 的 rotate。 |
| autopause | true | 滑鼠移入前後頁按鈕時暫停自動播放。 |
| interval | 3000 | 自動切換的間隔毫秒數,僅在 autoplay 啟用或呼叫 play() 時有效。 |
| clickable | true | 設為 true 時,點擊投影片本身即可前進到下一張。 |
同一頁面上若要放多組幻燈片,需把該組的頁籤、面板與前後頁按鈕包在同一個共同容器內,邏輯與建立多組 tabs 相同。
getconf():取得設定物件(1.2.0 起)。getTabs():取得 tabs API 的參考(1.2.0 起)。play():開始播放。pause():暫停播放,滑鼠移離頁籤、面板與導覽按鈕後會恢復。stop():停止播放,只能再呼叫 play() 恢復。事件方面提供 onBeforePlay、onPlay、onBeforePause、onPause,其中 onBeforePlay 與 onBeforePause 的 callback 回傳 false 即可取消該動作。所有事件監聽器的第一個參數都是 event 物件。