Bootstrap JS Carousel
JS Carousel (carousel.js)
Carousel 插件是一个用于在元素间循环的组件,比如 轮播(幻灯片)。
学习更多有关 Carousel 的知识, 请访问本站的 Bootstrap 轮播/幻灯片教程.
注意:Internet Explorer 9 及更早版本不支持 Carousel(因为它们使用 CSS3 转换和动画来实现幻灯片效果)。
Carousel 插件类
| 类 | 描述 |
|---|---|
| .carousel | 创建一个轮播/幻灯片 |
| .slide | 在从一个项滑动到下一个项时添加 CSS 过渡和动画效果。如果不想产生这种效果,请删除此样式类 |
| .carousel-indicators | 为轮播添加指示器。这些是每张幻灯片底部的小点(指示轮播中有多少张幻灯片,以及用户当前正在查看的幻灯片) |
| .carousel-inner | 为轮播添加滑动 |
| .icon-next | Unicode图标(箭头指向右侧),用于轮播。这通常用来代替字形图标 |
| .icon-prev | Unicode图标(箭头指向左侧),用于轮播。这通常用来代替字形图标 |
| .item | 指定滑动的内容 |
| .left carousel-control | 向轮播添加一个左按钮,可用让用户在幻灯片之间返回 |
| .right carousel-control | 向轮播添加一个右按钮,可用让用户在幻灯片之间返回 |
| .carousel-caption | 为轮播指定一个标题 |
通过 data-* 属性
data-ride="carousel" 属性激活 carousel 轮播。
data-slide 和 data-slide-to 指定滑动那到哪里。
data-slide 属性可用接受两个值: prev 和 next, data-slide-to 只接受数字。
实例
<!-- Carousel --><div id="myCarousel" class="carousel slide" data-ride="carousel"><!-- Carousel Indicators --><li data-target="#myCarousel" data-slide-to="1"></li><!-- Carousel Controls --><a class="left carousel-control" href="#myCarousel" data-slide="prev">
通过 JavaScript
手动:
实例
// Activate Carousel$("#myCarousel").carousel();// Enable Carousel Indicators$(".item").click(function(){$("#myCarousel").carousel(1);});// Enable Carousel Controls$(".left").click(function(){$("#myCarousel").carousel("prev");});
Carousel Options
Options 可以通过数据属性或 JavaScript 传递。对于数据属性,将选项名称附加到 data-,如 data-interval=""
| 名称 | 类型 | 默认 | 描述 | 试一试 |
|---|---|---|---|---|
| interval | 数字, 或者 false | 5000 | 指定每张幻灯片之间的延迟(以毫秒为单位) 备注: 将 interval 设置为 false 来停止项自动滑动 | 使用 JS 使用 data |
| pause | 字符串, 或 false | "hover" | 当鼠标指针进入 Carousel 时,暂停轮播进行下一张幻灯片,当鼠标指针离开 Carousel 时,继续滑动 备注: 将 pause 设置为 false 则鼠标悬浮 Carousel 时不会停止轮播 | 使用 JS Using data |
| wrap | boolean | true | 指定 Carousel 是应连续浏览所有幻灯片,还是应在最后一张幻灯片上停止
| 使用 JS 使用 data |
Carousel 方法
下表列出了所有可用的 Carousel 方法。
| 方法 | 描述 | 试一试 |
|---|---|---|
| .carousel(options) | 使用一个选项激活 Carousel。有关有效值,请参见上面的选项 | 试一试 |
| .carousel("cycle") | 从左到右遍历 Carousel 轮播项 | 试一试 |
| .carousel("pause") | 阻止 Carousel 遍历项 | 试一试 |
| .carousel(number) | 转到指定的项(从 0 开始:第一项为 0,第二项为 1,以此类推) | 试一试 |
| .carousel("prev") | 转到前一项 | 试一试 |
| .carousel("next") | 转到下一项 | 试一试 |
Carousel 事件
下表列出了所有可用的 Carousel 事件。
| 事件 | 描述 | 试一试 |
|---|---|---|
| slide.bs.carousel | 在 Carousel 轮播即将从一个项滑动到另一个项时发生 | 试一试 |
| slid.bs.carousel | 当轮播从一个项滑动到另一个项时发生 | 试一试 |
更多实例
轮播文字说明
为每一个 <div class="item"> 都添加一个 <div class="carousel-caption"> 来给每个轮播项都创建文字说明:
实例
<div id="myCarousel" class="carousel slide" data-ride="carousel"><!-- Indicators --><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><!-- Wrapper for slides --><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>The atmosphere in Chania has a touch of Florence and Venice.</p></div></div><div class="item"><img src="img_chania2.jpg" alt="Chania"><div class="carousel-caption"><h3>Chania</h3><p>The atmosphere in Chania has a touch of Florence and Venice.</p></div></div><div class="item"><img src="img_flower.jpg" alt="Flower"><div class="carousel-caption"><h3>Flowers</h3><p>Beautiful flowers in Kolymbari, Crete.</p></div></div><div class="item"><img src="img_flower2.jpg" alt="Flower"><div class="carousel-caption"><h3>Flowers</h3><p>Beautiful flowers in Kolymbari, Crete.</p></div></div></div><!-- Left and right controls --><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">Previous</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">Next</span></a></div>