Bootstrap 是基於 HTML、CSS 與 JavaScript 的前端框架,主打快速開發。本文聚焦其中的 Carousel 外掛,把結構、data 屬性、選項、方法與事件一次梳理清楚。
案例

<div id="carousel-example-generic" class="carousel slide" data-ride="carousel">
<!-- Indicators -->
<ol class="carousel-indicators">
<li data-target="#carousel-example-generic" data-slide-to="0" class="active"></li>
<li data-target="#carousel-example-generic" data-slide-to="1"></li>
<li data-target="#carousel-example-generic" data-slide-to="2"></li>
</ol>
<!-- Wrapper for slides -->
<div class="carousel-inner">
<div class="item active">
<img src="..." alt="...">
<div class="carousel-caption"> ... </div>
</div>
...
</div>
<!-- Controls -->
<a class="left carousel-control" href="#carousel-example-generic" data-slide="prev">
<span class="glyphicon glyphicon-chevron-left"></span>
</a>
<a class="right carousel-control" href="#carousel-example-generic" data-slide="next">
<span class="glyphicon glyphicon-chevron-right"></span>
</a>
</div>
IE 8 與 9 不支援過渡動畫。Bootstrap 的動畫建構在 CSS3 之上,這兩種瀏覽器缺少必要屬性,因此會直接失去轉場效果,而官方並不打算用 jQuery 補回來。
在任一 .item 中加入 .carousel-caption,即可為該幀加上說明文字,裡面可以放任意 HTML,Bootstrap 會自動排版:
<div class="item active">
<img src="..." alt="...">
<div class="carousel-caption">
<h3>...</h3>
<p>...</p>
</div>
</div>
建議圖片尺寸 900x500。
可訪問性問題:輪播元件並不符合無障礙標準。若專案有合規需求,請改用其他幻燈片方案。
透過 data 屬性
data-slide 接受 prev 或 next;data-slide-to 傳入以 0 起算的索引;data-ride="carousel" 則標記頁面載入後即自動啟動。
透過 JavaScript
$('.carousel').carousel()
選項
選項可透過 data 屬性或 JavaScript 傳入。使用 data 屬性時,把選項名接在 data- 之後,例如 data-interval=""。
· interval(number,預設 5000):幻燈片輪換等待時間。設為 false 則不自動循環。
· pause(string,預設 "hover"):滑鼠停留在輪播區即暫停,離開即恢復。
· wrap(boolean,預設 true):是否持續循環。
.carousel(options)——初始化並開始循環,可接受 options 物件:
$('.carousel').carousel({ interval: 2000 }).carousel('cycle');
.carousel('cycle')——從左到右循環各幀。
.carousel('pause')——停止輪播。
.carousel(number)——定位到指定幀,索引從 0 起,概念等同陣列。
.carousel('prev')——回到上一幀。
.carousel('next')——前往下一幀。
輪播元件對外暴露兩個事件:
· slide.bs.carousel:在 slide 方法被呼叫後立即觸發,此時動畫尚未開始。
· slid.bs.carousel:所有幻燈片播放完畢、動畫結束後觸發。
$('#myCarousel').on('slide.bs.carousel', function () {
// do something…
})
實務上的差別很重要:若要在切換前取得目前索引或預先載入下一張圖,用 slide;若要在動畫結束後才更新計數器或懶載入,用 slid。選錯時機,很容易出現視覺上的閃跳。