Bootstrap 4 JS 輪播圖
輪播圖 CSS 類
有關輪播圖的教程，請閱讀我們的 Bootstrap 輪播圖教程。
| 類 | 描述 |
|---|---|
.carousel |
建立輪播 |
.carousel-indicators |
為輪播新增指示器。這些是每個幻燈片底部的點（指示輪播中有多少個幻燈片，以及使用者當前正在檢視哪個幻燈片）。 |
.carousel-inner |
為輪播新增幻燈片 |
.carousel-item |
指定每個幻燈片的內容 |
.carousel-control-prev |
為輪播圖新增一個左側（上一個）按鈕，允許使用者在幻燈片之間後退 |
.carousel-control-next |
為輪播圖新增一個右側（下一個）按鈕，允許使用者在幻燈片之間前進 |
.carousel-control-prev-icon |
與 .carousel-control-prev 一起使用以建立“上一個”按鈕 |
.carousel-control-next-icon |
與 .carousel-control-next 一起使用以建立“下一個”按鈕 |
.carousel-caption |
為輪播圖指定一個標題 |
.slide |
在從一個專案滑動到下一個專案時新增 CSS 過渡和動畫效果。如果您不想要此效果，請刪除此類。 |
透過 data-* 屬性
data-ride="carousel" 屬性會啟用輪播圖。
data-slide 和 data-slide-to 屬性指定要跳轉到的幻燈片。
data-slide 屬性接受兩個值：prev 或 next，而 data-slide-to 接受數字。
示例
<!-- Carousel -->
<div id="myCarousel" class="carousel slide" data-ride="carousel">
<!-- 輪播圖指示器 -->
<li data-target="#myCarousel" data-slide-to="1"></li>
<!-- 輪播圖控制元件 -->
<a class="carousel-control-prev" href="#myCarousel" data-slide="prev">
<span class="carousel-control-prev-icon"></span>
</a>
自己動手試一試 »
透過 JavaScript
使用以下命令手動啟用：
示例
// 啟用輪播圖
$("#myCarousel").carousel();
// 啟用輪播圖指示器
$(".item").click(function(){
$("#myCarousel").carousel(1);
});
// 啟用輪播圖控制元件
$(".carousel-control-prev").click(function(){
$("#myCarousel").carousel("prev");
});
自己動手試一試 »
輪播圖選項
可以透過 data 屬性或 JavaScript 傳遞選項。對於 data 屬性，將選項名稱附加到 data-，例如 data-interval="".
| 名稱 | 型別 | 預設值 | 描述 | 試一試 |
|---|---|---|---|---|
| interval | number，或布林值 false | 5000 | 指定每張幻燈片之間的延遲（以毫秒為單位）。 注意：將 interval 設定為 false 可停止幻燈片自動播放 |
使用 JS 使用 data |
| 鍵盤 | boolean | true | 指定輪播圖是否響應鍵盤事件
|
使用 JS 使用 data |
| pause | 字串，或布林值 false | "hover" | 當滑鼠指標進入輪播圖時，暫停輪播圖自動播放下一張幻燈片，當滑鼠指標離開輪播圖時恢復播放 注意：將 pause 設定為 false 可停止懸停暫停功能 |
使用 JS 使用 data |
| wrap（換行） | boolean | true | 指定輪播圖是連續播放所有幻燈片，還是在最後一張幻燈片停止
|
使用 JS 使用 data |
輪播圖方法
下表列出了所有可用的輪播圖方法。
| 方法 | 描述 | 試一試 |
|---|---|---|
| .carousel(options) | 使用一個選項啟用輪播圖。有關有效值，請參閱上面的選項 | 試一試 |
| .carousel("cycle") | 從左到右遍歷輪播圖的各項 | 試一試 |
| .carousel("pause") | 停止輪播圖播放各項 | 試一試 |
| .carousel(number) | 跳轉到指定的某一項（零基索引：第一項為 0，第二項為 1，依此類推） | 試一試 |
| .carousel("prev") | 跳轉到上一項 | 試一試 |
| .carousel("next") | 跳轉到下一項 | 試一試 |
| .carousel("dispose") | 銷燬一個輪播圖 |
輪播圖事件
下表列出了所有可用的輪播圖事件。
| 事件 | 描述 | 試一試 |
|---|---|---|
| slide.bs.carousel | 當輪播圖即將從一個專案滑動到另一個專案時觸發 | 試一試 |
| slid.bs.carousel | 當輪播圖完成從一個專案滑動到另一個專案時觸發 | 試一試 |
slid 和 slide 事件還包含其他屬性
| 屬性 | 描述 | 試一試 |
|---|---|---|
| direction | 返回輪播圖滑動的方向（左或右） | |
| relatedTarget | 返回正在滑動到位的 DOM 元素，作為活動項 | 試一試 |
| from | 返回前一項的索引，當移動到下一項時 | 試一試 |
| to | 返回下一項的索引 | 試一試 |
