ブートストラップカルーセル


Bootstrap Carousel Plugin

Bootstrap Carousel Plugin は、サイトにスライダーを追加するための柔軟で応答性の高い方法です。さらに、コンテンツは十分に柔軟であり、画像、iframe、ビデオ、またはその他の任意のタイプのコンテンツを配置できます。

このプラグインの機能を個別に参照したい場合は、carousel.jsを参照する必要があります。または、「ブートストラップ プラグインの概要」の章で説明したように、bootstrap.js または bootstrap.min.js の縮小バージョンを参照できます。

例

以下は、Bootstrap Carousel プラグインを使用して要素をループする共通コンポーネントを表示する簡単なスライドショーです。カルーセルを実装するには、そのタグを含むコードを追加するだけです。 data 属性を使用する必要はなく、単純なクラスベースの開発だけを行うことができます。

インスタンス

<!DOCTYPE html>
<html>
<head>
   <title>Bootstrap 实例 - 简单的轮播（Carousel）插件</title>
  <link href="http://libs.baidu.com/bootstrap/3.3.0/css/bootstrap.min.css" rel="stylesheet">
  <script src="http://libs.baidu.com/jquery/2.0.0/jquery.min.js"></script>
  <script src="http://libs.baidu.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
</head>
<body>

<div id="myCarousel" class="carousel slide">
   <!-- 轮播（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>
   </ol>   
   <!-- 轮播（Carousel）项目 -->
   <div class="carousel-inner">
      <div class="item active">
         <img src="/wp-content/uploads/2014/07/slide1.png" alt="First slide">
      </div>
      <div class="item">
         <img src="/wp-content/uploads/2014/07/slide2.png" alt="Second slide">
      </div>
      <div class="item">
         <img src="/wp-content/uploads/2014/07/slide3.png" alt="Third slide">
      </div>
   </div>
   <!-- 轮播（Carousel）导航 -->
   <a class="carousel-control left" href="#myCarousel" 
      data-slide="prev">‹</a>
   <a class="carousel-control right" href="#myCarousel" 
      data-slide="next">›</a>
</div> 

</body>
</html>

インスタンスの実行»

「インスタンスの実行」ボタンをクリックしてオンラインインスタンスを表示します

オプションのタイトル

.item内で.carousel-caption要素を渡すことができますスライドにタイトルを追加します。オプションの HTML をそこに配置するだけで、自動的に位置が調整され、フォーマットされます。次の例はこれを示しています:

インスタンス

<!DOCTYPE html>
<html>
<head>
   <title>Bootstrap 实例 - 轮播（Carousel）插件的标题</title>
   <link href="http://libs.baidu.com/bootstrap/3.3.0/css/bootstrap.min.css" rel="stylesheet">
  <script src="http://libs.baidu.com/jquery/2.0.0/jquery.min.js"></script>
  <script src="http://libs.baidu.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
</head>
<body>

<div id="myCarousel" class="carousel slide">
   <!-- 轮播（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>
   </ol>   
   <!-- 轮播（Carousel）项目 -->
   <div class="carousel-inner">
      <div class="item active">
         <img src="/wp-content/uploads/2014/07/slide1.png" alt="First slide">
         <div class="carousel-caption">标题 1</div>
      </div>
      <div class="item">
         <img src="/wp-content/uploads/2014/07/slide2.png" alt="Second slide">
         <div class="carousel-caption">标题 2</div>
      </div>
      <div class="item">
         <img src="/wp-content/uploads/2014/07/slide3.png" alt="Third slide">
         <div class="carousel-caption">标题 3</div>
      </div>
   </div>
   <!-- 轮播（Carousel）导航 -->
   <a class="carousel-control left" href="#myCarousel" 
      data-slide="prev">‹</a>
   <a class="carousel-control right" href="#myCarousel" 
      data-slide="next">›</a>
</div> 


</body>
</html>

インスタンスの実行»

「インスタンスの実行」ボタンをクリックしてオンライン例を表示します

使用法

  • データ属性別: データを使用します属性 to カルーセルの位置を制御するのは簡単です。

    • プロパティ data-slide は、現在の位置を基準にしてスライドの位置を変更するために使用されるキーワード prev または next を受け入れます。

    • 生のスライド インデックスをカルーセルに渡すには data-slide-to を使用します。data-slide-to="2" は、スライダーを 0 から数えて特定のインデックスに移動します。

    • data-ride="carousel" 属性は、ページの読み込み時にアニメーションを開始するカルーセルをマークするために使用されます。

  • JavaScript 経由: カルーセルは、次のように JavaScript 経由で手動で呼び出すことができます:

$('.carousel').carousel()

オプション

一部のオプションは、データ属性または JavaScript を通じて渡されます。次の表にオプションを示します。

データ間隔 各項目間の遅延時間を自動的にループします。 false の場合、カルーセルは自動的にループしません。 pausestringdata-pause マウスが入るとカルーセル ループを一時停止し、マウスが離れるとカルーセル ループを再開します。 wrapbooleandata-wrap カルーセルが継続的にループするかどうか。
オプション名 タイプ/デフォルト値 データプロパティ名 説明
間隔番号
デフォルト値: 5000

デフォルト値: "hover"

デフォルト値: true
メソッド

カルーセルプラグインの便利なメソッドをいくつか紹介します:

説明インスタンス
$('#identifier').carousel({
  interval: 2000
})
$('#identifier').carousel('cycle')
$('#identifier').carousel('pause')
$('#identifier').carousel(number)
$('#identifier').carousel('prev')
$('#identifier').carousel('next')
Instance以下の例は、メソッドの使用法を示しています
.carousel(options)カルーセルが利用可能になります オプションを選択してくださいオブジェクトを選択し、アイテムのループを開始します。
.carousel('cycle') カルーセル項目を左から右に循環します。
.carousel('pause')カルーセルループ項目を停止します。
.carousel(number) 特定のフレームにループします (配列と同様に 0 からカウントが始まります)。
.carousel('prev')前の項目に移動します。
.carousel('next')次の項目に移動します。
Instance

<!DOCTYPE html>
<html>
<head>
   <title>Bootstrap 实例 - 轮播（Carousel）插件方法</title>
  <link href="http://libs.baidu.com/bootstrap/3.3.0/css/bootstrap.min.css" rel="stylesheet">
  <script src="http://libs.baidu.com/jquery/2.0.0/jquery.min.js"></script>
  <script src="http://libs.baidu.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
</head>
<body>

<div id="myCarousel" class="carousel slide">
   <!-- 轮播（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>
   </ol>   
   <!-- 轮播（Carousel）项目 -->
   <div class="carousel-inner">
      <div class="item active">
         <img src="/wp-content/uploads/2014/07/slide1.png" alt="First slide">
      </div>
      <div class="item">
         <img src="/wp-content/uploads/2014/07/slide2.png" alt="Second slide">
      </div>
      <div class="item">
         <img src="/wp-content/uploads/2014/07/slide3.png" alt="Third slide">
      </div>
   </div>
   <!-- 轮播（Carousel）导航 -->
   <a class="carousel-control left" href="#myCarousel" 
      data-slide="prev">‹</a>
   <a class="carousel-control right" href="#myCarousel" 
      data-slide="next">›</a>
   <!-- 控制按钮 -->
   <div style="text-align:center;">
      <input type="button" class="btn start-slide" value="Start">
      <input type="button" class="btn pause-slide" value="Pause">
      <input type="button" class="btn prev-slide" value="Previous Slide">
      <input type="button" class="btn next-slide" value="Next Slide">
      <input type="button" class="btn slide-one" value="Slide 1">
      <input type="button" class="btn slide-two" value="Slide 2">            
      <input type="button" class="btn slide-three" value="Slide 3">
   </div>
</div> 
<script>
   $(function(){
      // 初始化轮播
      $(".start-slide").click(function(){
         $("#myCarousel").carousel('cycle');
      });
      // 停止轮播
      $(".pause-slide").click(function(){
         $("#myCarousel").carousel('pause');
      });
      // 循环轮播到上一个项目
      $(".prev-slide").click(function(){
         $("#myCarousel").carousel('prev');
      });
      // 循环轮播到下一个项目
      $(".next-slide").click(function(){
         $("#myCarousel").carousel('next');
      });
      // 循环轮播到某个特定的帧 
      $(".slide-one").click(function(){
         $("#myCarousel").carousel(0);
      });
      $(".slide-two").click(function(){
         $("#myCarousel").carousel(1);
      });
      $(".slide-three").click(function(){
         $("#myCarousel").carousel(2);
      });
   });
</script>


</body>
</html>

インスタンスの実行»

オンラインインスタンスを表示するには、「インスタンスの実行」ボタンをクリックしてください

イベント Down この表には、カルーセル プラグインで使用されるイベントがリストされています。これらのイベントは関数のフックとして使用できます。

Event

DescriptionInstance
$('#identifier').on('slide.bs.carousel', function () {
  // 执行一些动作...
})
$('#identifier').on('slid.bs.carousel', function () {
  // 执行一些动作...
})
インスタンス次の例は、イベントの使用法を示しています:
slide.bs.carouselこのイベントは、スライド インスタンス メソッドが呼び出されるとすぐにトリガーされます。
slid.bs.carousel このイベントは、カルーセルがスライド トランジション エフェクトを完了するとトリガーされます。
インスタンス

<!DOCTYPE html>
<html>
<head>
   <title>Bootstrap 实例 - 轮播（Carousel）插件事件</title>
   <link href="http://libs.baidu.com/bootstrap/3.3.0/css/bootstrap.min.css" rel="stylesheet">
  <script src="http://libs.baidu.com/jquery/2.0.0/jquery.min.js"></script>
  <script src="http://libs.baidu.com/bootstrap/3.3.0/js/bootstrap.min.js"></script>
</head>
<body>

<div id="myCarousel" class="carousel slide">
   <!-- 轮播（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>
   </ol>   
   <!-- 轮播（Carousel）项目 -->
   <div class="carousel-inner">
      <div class="item active">
         <img src="/wp-content/uploads/2014/07/slide1.png" alt="First slide">
      </div>
      <div class="item">
         <img src="/wp-content/uploads/2014/07/slide2.png" alt="Second slide">
      </div>
      <div class="item">
         <img src="/wp-content/uploads/2014/07/slide3.png" alt="Third slide">
      </div>
   </div>
   <!-- 轮播（Carousel）导航 -->
   <a class="carousel-control left" href="#myCarousel" 
      data-slide="prev">‹</a>
   <a class="carousel-control right" href="#myCarousel" 
      data-slide="next">›</a>
</div> 
<script>
   $(function(){
      $('#myCarousel').on('slide.bs.carousel', function () {
         alert("当调用 slide 实例方法时立即触发该事件。");
      });
   });
</script>

</body>
</html>

インスタンスの実行 »

「インスタンスの実行」ボタンをクリックしてオンラインインスタンスを表示します

←
→