carousel循环轮播会自动循环轮播,也可以通过按钮前进或后退,一般用于网页显著的位置,比如视频网站的首页可用此组件展示最新电影海报。
<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" role="listbox">
<div class="item active">
<img src="..." alt="...">
<div class="carousel-caption">
...
</div>
</div>
<div class="item">
<img src="..." alt="...">
<div class="carousel-caption">
...
</div>
</div>
...
</div>
<!-- Controls -->
<a class="left carousel-control" href="#carousel-example-generic" role="button" data-slide="prev">
<span class="glyphicon glyphicon-chevron-left" aria-hidden="true"></span>
<span class="sr-only">Previous</span>
</a>
<a class="right carousel-control" href="#carousel-example-generic" role="button" data-slide="next">
<span class="glyphicon glyphicon-chevron-right" aria-hidden="true"></span>
<span class="sr-only">Next</span>
</a>
</div>
<div class="item">
<img src="..." alt="...">
<div class="carousel-caption">
<h3>...</h3>
<p>...</p>
</div>
</div>
有两种方式来进行参数设置:
data-加参数名的形式构建该元素的自定义属性,比如data-interval="1000"$('#example').carousel(options)方式
常用的Options有:
| 参数名 | 数据类型 | 默认值 | 说明 |
|---|---|---|---|
| interval | 数字型 | 5000 | 自动轮播的间隔时间,单位为毫秒 |
| pause | 字符串或null | "hover" | 自动轮播间隔时间计时暂停的触发事件,比如默认为hover即鼠标悬停时,自动轮播计时暂停,鼠标若在这悬停一辈子,就会一直显示当前页一辈子 |
| wrap | 布尔型 | true | 轮播结束是否继续从第一页开始而循环 |
| keyboard | 布尔型 | true | 选中组件状态下,是否可以通过键盘的前进后退键来控制轮播 |
$("#example").carousel(option)
| option命令 | 说明 |
|---|---|
| "cycle" | 开启轮播计时 |
| "pause" | 暂停轮播计时 |
| number | 直接跳到指定页(从0开始计数,0代表第一页) |
| "prev" | carousel循环轮播后退一页 |
| "next" | carousel循环轮播前进一页 |
示例:文档加载完毕后,暂停轮播
$(document).ready(function(){
$('#carousel-example-captions').carousel("pause");
});
| 事件 | 说明 |
|---|---|
| slide.bs.carousel | 当一次slide滑动轮播动作开始,则触发预设事件 |
| slid.bs.carousel | 当一次slide滑动轮播动作完毕,则触发预设事件 |
示例:当一次slide滑动轮播动作完毕,则触发预设事件(弹出“反清复明”)
$('#carousel-example-captions').on('slid.bs.carousel', function (){
alert( "反清复明" );
});