Bootstrap 輪播(Carousel)插件是一種靈活的響應式的向站點添加滑塊的方式。除此以外,內容也是足夠靈活的,能夠是圖像、內嵌框架、視頻或者其餘您想要放置的任何類型的內容。下面咱們經過一些實例,演示一下其中的一些用法。若有不足,敬請原諒。bootstrap
若是您想要單獨引用該插件的功能,那麼您須要引用 carousel.js。您能夠引用 bootstrap.js 或壓縮版的 bootstrap.min.js。
下面是一個簡單的幻燈片,使用 Bootstrap 輪播(Carousel)插件顯示了一個循環播放元素的通用組件。爲了實現輪播,您只須要添加帶有該標記的代碼便可。不須要使用 data 屬性,只須要簡單的基於 class 的開發便可。數組
實例
<div id="myCarousel" class="carousel slide">
<!-- 輪播(Carousel)指標 -->
<ol class="carousel-indicators">
<li data-target="#myCarousel" data-slide-to="0" class="active"></li>
<li data-target="#myCarousel" data-slide-to="1"></li>
<li data-target="#myCarousel" data-slide-to="2"></li>
</ol>
<!-- 輪播(Carousel)項目 -->
<div class="carousel-inner">
<div class="item active">
<img src="/wp-content/uploads/2014/07/slide1.png" alt="First slide">
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide2.png" alt="Second slide">
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide3.png" alt="Third slide">
</div>
</div>
<!-- 輪播(Carousel)導航 -->
<a class="carousel-control left" href="#myCarousel" data-slide="prev">‹ </a>
<a class="carousel-control right" href="#myCarousel" data-slide="next">› </a>
</div>
結果以下所示:框架
可選的標題
您能夠經過 .item 內的 .carousel-caption 元素向幻燈片添加標題。只須要在該處放置任何可選的 HTML 便可,它會自動對齊並格式化。下面的實例演示了這點:ide
實例
<div id="myCarousel" class="carousel slide">
<!-- 輪播(Carousel)指標 -->
<ol class="carousel-indicators">
<li data-target="#myCarousel" data-slide-to="0" class="active"></li>
<li data-target="#myCarousel" data-slide-to="1"></li>
<li data-target="#myCarousel" data-slide-to="2"></li>
</ol>
<!-- 輪播(Carousel)項目 -->
<div class="carousel-inner">
<div class="item active">
<img src="/wp-content/uploads/2014/07/slide1.png" alt="First slide">
<div class="carousel-caption">標題 1</div>
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide2.png" alt="Second slide">
<div class="carousel-caption">標題 2</div>
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide3.png" alt="Third slide">
<div class="carousel-caption">標題 3</div>
</div>
</div>
<!-- 輪播(Carousel)導航 -->
<a class="carousel-control left" href="#myCarousel" data-slide="prev">‹ </a>
<a class="carousel-control right" href="#myCarousel" data-slide="next">› </a>
</div>
結果以下所示:函數
用法
- 經過 data 屬性:使用 data 屬性能夠很容易控制輪播(Carousel)的位置。
- 屬性 data-slide 接受關鍵字 prev 或 next,用來改變幻燈片相對於當前位置的位置。
- 使用 data-slide-to 來向輪播傳遞一個原始滑動索引,data-slide-to="2" 將把滑塊移動到一個特定的索引,索引從 0 開始計數。
- data-ride="carousel" 屬性用於標記輪播在頁面加載時就開始動畫播放。
- 經過 JavaScript:輪播(Carousel)可經過 JavaScript 手動調用,以下所示:
$('.carousel').carousel()
選項
有一些選項是經過 data 屬性或 JavaScript 來傳遞的。下表列出了這些選項:動畫
選項名稱 | 類型/默認值 | Data 屬性名稱 | 描述 |
---|---|---|---|
interval | number 默認值:5000 |
data-interval | 自動循環每一個項目之間延遲的時間量。若是爲 false,輪播將不會自動循環。 |
pause | string 默認值:"hover" |
data-pause | 鼠標進入時暫停輪播循環,鼠標離開時恢復輪播循環。 |
wrap | boolean 默認值:true |
data-wrap | 輪播是否連續循環。 |
方法
下面是一些輪播(Carousel)插件中有用的方法:spa
方法 | 描述 | 實例 |
---|---|---|
.carousel(options) | 初始化輪播爲可選的 options 對象,並開始循環項目。 | $('#identifier').carousel({ interval: 2000 }) |
.carousel('cycle') | 從左到右循環輪播項目。 | $('#identifier').carousel('cycle') |
.carousel('pause') | 中止輪播循環項目。 | $('#identifier').carousel('pause') |
.carousel(number) | 循環輪播到某個特定的幀(從 0 開始計數,與數組相似)。 | $('#identifier').carousel(number) |
.carousel('prev') | 循環輪播到上一個項目。 | $('#identifier').carousel('prev') |
.carousel('next') | 循環輪播到下一個項目。 | $('#identifier').carousel('next') |
下面的實例演示了方法的用法:插件
實例
<div id="myCarousel" class="carousel slide">
<!-- 輪播(Carousel)指標 -->
<ol class="carousel-indicators">
<li data-target="#myCarousel" data-slide-to="0" class="active"></li>
<li data-target="#myCarousel" data-slide-to="1"></li>
<li data-target="#myCarousel" data-slide-to="2"></li>
</ol>
<!-- 輪播(Carousel)項目 -->
<div class="carousel-inner">
<div class="item active">
<img src="/wp-content/uploads/2014/07/slide1.png" alt="First slide">
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide2.png" alt="Second slide">
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide3.png" alt="Third slide">
</div>
</div>
<!-- 輪播(Carousel)導航 -->
<a class="carousel-control left" href="#myCarousel" data-slide="prev">‹</a>
<a class="carousel-control right" href="#myCarousel" data-slide="next">›</a>
<!-- 控制按鈕 -->
<div style="text-align:center;">
<input type="button" class="btn start-slide" value="Start">
<input type="button" class="btn pause-slide" value="Pause">
<input type="button" class="btn prev-slide" value="Previous Slide">
<input type="button" class="btn next-slide" value="Next Slide">
<input type="button" class="btn slide-one" value="Slide 1">
<input type="button" class="btn slide-two" value="Slide 2">
<input type="button" class="btn slide-three" value="Slide 3">
</div>
</div>
<script>
$(function(){ // 初始化輪播
$(".start-slide").click(function(){ $("#myCarousel").carousel('cycle'); }); // 中止輪播
$(".pause-slide").click(function(){ $("#myCarousel").carousel('pause'); }); // 循環輪播到上一個項目
$(".prev-slide").click(function(){ $("#myCarousel").carousel('prev'); }); // 循環輪播到下一個項目
$(".next-slide").click(function(){ $("#myCarousel").carousel('next'); }); // 循環輪播到某個特定的幀
$(".slide-one").click(function(){ $("#myCarousel").carousel(0); });
$(".slide-two").click(function(){ $("#myCarousel").carousel(1); });
$(".slide-three").click(function(){ $("#myCarousel").carousel(2); });
});
</script>
結果以下所示:視頻
事件
下表列出了輪播(Carousel)插件中要用到的事件。這些事件可在函數中當鉤子使用。對象
事件 | 描述 | 實例 |
---|---|---|
slide.bs.carousel | 當調用 slide 實例方法時當即觸發該事件。 | $('#identifier').on('slide.bs.carousel', function () { // 執行一些動做... }) |
slid.bs.carousel | 當輪播完成幻燈片過渡效果時觸發該事件。 | $('#identifier').on('slid.bs.carousel', function () { // 執行一些動做... }) |
下面的實例演示了事件的用法:
實例
<div id="myCarousel" class="carousel slide">
<!-- 輪播(Carousel)指標 -->
<ol class="carousel-indicators">
<li data-target="#myCarousel" data-slide-to="0" class="active"></li>
<li data-target="#myCarousel" data-slide-to="1"></li>
<li data-target="#myCarousel" data-slide-to="2"></li>
</ol>
<!-- 輪播(Carousel)項目 -->
<div class="carousel-inner">
<div class="item active">
<img src="/wp-content/uploads/2014/07/slide1.png" alt="First slide">
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide2.png" alt="Second slide">
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide3.png" alt="Third slide">
</div>
</div>
<!-- 輪播(Carousel)導航 -->
<a class="carousel-control left" href="#myCarousel" data-slide="prev">‹</a>
<a class="carousel-control right" href="#myCarousel" data-slide="next">›</a>
</div>
<script>
$(function(){
$('#myCarousel').on('slide.bs.carousel', function () { alert("當調用 slide 實例方法時當即觸發該事件。"); });
});
</script>
結果以下所示: