Bootstrap JS 轮播
JS 轮播 (carousel.js)
轮播插件是用于循环遍历元素的组件,例如轮播(幻灯片)。
有关轮播的教程,请阅读我们的 Bootstrap 轮播教程。
注意:轮播在 Internet Explorer 9 及更早版本中不受支持(因为它们使用 CSS3 过渡和动画来实现滑动效果)。
轮播插件类
类 | 描述 |
---|---|
.carousel | 创建轮播 |
.slide | 在从一个项目滑动到下一个项目时添加 CSS 过渡和动画效果。如果您不希望此效果,请删除此类 |
.carousel-indicators | 为轮播添加指示器。这些是每个幻灯片底部的小圆点(指示轮播中有多少个幻灯片,以及用户当前正在查看哪个幻灯片) |
.carousel-inner | 将幻灯片添加到轮播 |
.icon-next | Unicode 图标(箭头指向右),用于轮播。这通常用于代替图示 |
.icon-prev | Unicode 图标(箭头指向左),用于轮播。这通常用于代替图示 |
.item | 指定每个幻灯片的内容 |
.left carousel-control | 在轮播中添加一个左按钮,允许用户在幻灯片之间返回 |
.right carousel-control | 在轮播中添加一个右按钮,允许用户在幻灯片之间前进 |
.carousel-caption | 指定轮播的标题 |
通过 data-* 属性
The data-ride="carousel"
attribute activates the carousel.
The data-slide
and data-slide-to
attributes specifies which slide to go to.
The data-slide
attribute accepts two values: prev or next, while data-slide-to
accept numbers.
示例
<!-- 轮播 -->
<div id="myCarousel" class="carousel slide" data-ride="carousel">
<!-- 轮播指示器 -->
<li data-target="#myCarousel" data-slide-to="1"></li>
<!-- 轮播控件 -->
<a class="left carousel-control" href="#myCarousel" data-slide="prev">
自己尝试 »
通过 JavaScript
手动启用
示例
// 激活轮播
$("#myCarousel").carousel();
// 启用轮播指示器
$(".item").click(function(){
$("#myCarousel").carousel(1);
});
// 启用轮播控件
$(".left").click(function(){
$("#myCarousel").carousel("prev");
});
自己尝试 »
轮播选项
选项可以通过 data 属性或 JavaScript 传递。对于 data 属性,将选项名称附加到 data-,例如 data-interval=""。
名称 | 类型 | 默认值 | 描述 | 尝试 |
---|---|---|---|---|
interval | 数字,或布尔值 false | 5000 | 指定每个幻灯片之间的延迟(以毫秒为单位)。 注意:将 interval 设置为 false 以停止项目自动滑动 |
使用 JS 使用 data |
pause | 字符串,或布尔值 false | "hover" | 当鼠标指针进入轮播时,暂停轮播从下一个幻灯片开始,当鼠标指针离开轮播时,恢复滑动 注意:将 pause 设置为 false 以停止在悬停时暂停的能力 |
使用 JS 使用 data |
wrap | 布尔值 | true | 指定轮播是否应该连续地遍历所有幻灯片,或者在最后一个幻灯片处停止
|
使用 JS 使用 data |
轮播方法
下表列出了所有可用的轮播方法。
方法 | 描述 | 尝试 |
---|---|---|
.carousel(options) | 使用选项激活轮播。有关有效值,请参阅上面的选项 | 尝试 |
.carousel("cycle") | 从左到右遍历轮播项目 | 尝试 |
.carousel("pause") | 停止轮播遍历项目 | 尝试 |
.carousel(number) | 转到指定的项目(从零开始:第一个项目是 0,第二个项目是 1,等等…) | 尝试 |
.carousel("prev") | 转到前一个项目 | 尝试 |
.carousel("next") | 转到下一个项目 | 尝试 |
轮播事件
下表列出了所有可用的轮播事件。
事件 | 描述 | 尝试 |
---|---|---|
slide.bs.carousel | 当轮播即将从一个项目滑动到另一个项目时发生 | 尝试 |
slid.bs.carousel | 当轮播完成从一个项目滑动到另一个项目时发生 | 尝试 |
更多示例
幻灯片的标题
添加 <div class="carousel-caption">
到每个 <div class="item">
中,为每个幻灯片创建标题
示例
<div id="myCarousel" class="carousel slide" data-ride="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>
<li data-target="#myCarousel" data-slide-to="3"></li>
</ol>
<!-- 幻灯片的包装器 -->
<div class="carousel-inner" role="listbox">
<div class="item active">
<img src="img_chania.jpg" alt="Chania">
<div class="carousel-caption">
<h3>Chania</h3>
<p>Chania 的氛围带有一丝佛罗伦萨和威尼斯的韵味。</p>
</div>
</div>
<div class="item">
<img src="img_chania2.jpg" alt="Chania">
<div class="carousel-caption">
<h3>Chania</h3>
<p>Chania 的氛围带有一丝佛罗伦萨和威尼斯的韵味。</p>
</div>
</div>
<div class="item">
<img src="img_flower.jpg" alt="Flower">
<div class="carousel-caption">
<h3>花朵</h3>
<p>克里特岛 Kolymbari 的美丽花朵。</p>
</div>
</div>
<div class="item">
<img src="img_flower2.jpg" alt="Flower">
<div class="carousel-caption">
<h3>花朵</h3>
<p>克里特岛 Kolymbari 的美丽花朵。</p>
</div>
</div>
</div>
<!-- 左侧和右侧控件 -->
<a class="left carousel-control" href="#myCarousel" role="button" data-slide="prev">
<span class="glyphicon glyphicon-chevron-left" aria-hidden="true"></span>
<span class="sr-only">上一个</span>
</a>
<a class="right carousel-control" href="#myCarousel" role="button" data-slide="next">
<span class="glyphicon glyphicon-chevron-right" aria-hidden="true"></span>
<span class="sr-only">下一个</span>
</a>
</div>
自己尝试 »