ブートストラップ4JSカルーセル
カルーセルCSSクラス
カルーセルに関するチュートリアルについては、ブートストラップカルーセルチュートリアルをお読みください。
Class | Description |
---|---|
.carousel |
Creates a carousel |
.carousel-indicators |
Adds indicators for the carousel. These are the little dots at the bottom of each slide (which indicates how many slides there are in the carousel, and which slide the user are currently viewing) |
.carousel-inner |
Adds slides to the carousel |
.carousel-item |
Specifies the content of each slide |
.carousel-control-prev |
Adds a left (previous) button to the carousel, which allows the user to go back between the slides |
.carousel-control-next |
Adds a right (next) button to the carousel, which allows the user to go forward between the slides |
.carousel-control-prev-icon |
Used together with .carousel-control-prev to create a "previous" button |
.carousel-control-next-icon |
Used together with .carousel-control-next to create a "next" button |
.carousel-caption |
Specifies a caption for the carousel |
.slide |
Adds a CSS transition and animation effect when sliding from one item to the next. Remove this class if you do not want this effect |
データ経由-*属性
属性はdata-ride="carousel"
カルーセルをアクティブにします。
data-slide
and属性はdata-slide-to
、移動するスライドを指定します。
この属性は、 prevまたは
nextのdata-slide
2つの値を受け入れ、数値を
受け入れます。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="carousel-control-prev" href="#myCarousel" data-slide="prev">
<span class="carousel-control-prev-icon"></span>
</a>
JavaScript経由
次のコマンドで手動で有効にします。
例
// Activate Carousel
$("#myCarousel").carousel();
// Enable Carousel Indicators
$(".item").click(function(){
$("#myCarousel").carousel(1);
});
// Enable Carousel Controls
$(".carousel-control-prev").click(function(){
$("#myCarousel").carousel("prev");
});
カルーセルオプション
オプションは、データ属性またはJavaScriptを介して渡すことができます。データ属性の場合、data-interval = ""のように、オプション名をdata-に追加します。
Name | Type | Default | Description | Try it |
---|---|---|---|---|
interval | number, or the boolean false | 5000 | Specifies the delay (in milliseconds) between each slide. Note: Set interval to false to stop the items from automatically sliding |
|
keyboard | boolean | true | Specifies whether the carousel should react to keyboard events:
|
|
pause | string, or the boolean false | "hover" | Pauses the carousel from going through the next slide when the mouse pointer enters the carousel, and resumes the sliding when the mouse pointer leaves the carousel Note: Set pause to false to stop the ability to pause on hover |
|
wrap | boolean | true | Specifies whether the carousel should go through all slides continuously, or stop at the last slide
|
カルーセルメソッド
次の表に、使用可能なすべてのカルーセルメソッドを示します。
Method | Description | Try it |
---|---|---|
.carousel(options) | Activates the carousel with an option. See options above for valid values | |
.carousel("cycle") | Goes through the carousel items from left to right | |
.carousel("pause") | Stops the carousel from going through items | |
.carousel(number) | Goes to a specified item (zero-based: first item is 0, second item is 1, etc..) | |
.carousel("prev") | Goes to the previous item | |
.carousel("next") | Goes to the next item | |
.carousel("dispose") | Destroys a carousel |
カルーセルイベント
次の表に、利用可能なすべてのカルーセルイベントを示します。
Event | Description | Try it |
---|---|---|
slide.bs.carousel | Occurs when the carousel is about to slide from one item to another | |
slid.bs.carousel | Occurs when the carousel has finished sliding from one item to another |
スライドイベントとスライドイベントには、次の追加のプロパティもあります。
Property | Description | Try it |
---|---|---|
direction | Returns the direction the carousel is sliding (left or right) | |
relatedTarget | Returns the DOM element that is being slid into place as the active item | |
from | Returns the index of where the previous item came from, when moving on to the next one | |
to | Returns the index of the next item |