Bootstrap Plugin Carrousel
Le plugin Carrousel de Bootstrap est un moyen flexible et réactif d'ajouter des carrousels à votre site. De plus, le contenu est également suffisamment flexible pour être des images, des iframes, des vidéos ou tout autre type de contenu que vous souhaitez placer.
Si vous souhaitez référencer les fonctionnalités du plugin séparément, vous devez alors référencercarousel.js. Sinon, commePrésentation des plugins Bootstrapmentionné dans le chapitre, vous pouvez référencerbootstrap.jsou la version compressée debootstrap.min.js。
Exemple
Ci-dessous se trouve un simple diaporama qui utilise le plugin Carrousel de Bootstrap pour afficher un composant générique permettant de faire défiler des éléments. Pour implémenter le carrousel, vous devez seulement ajouter le code avec ce balisage. Aucun attribut data n'est nécessaire ; un simple développement basé sur des classes suffit.
Exemple
<div id="myCarousel" class="carousel slide">
<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>
<div class="carousel-inner">
<div class="item active">
<img src="/wp-content/uploads/2014/07/slide1.png" alt="Première diapositive">
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide2.png" alt="Deuxième diapositive">
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide3.png" alt="Troisième diapositive">
</div>
</div>
<a class="carousel-control left" href="#myCarousel"
data-slide="prev"> <span _ngcontent-c3="" aria-hidden="true" class="glyphicon glyphicon-chevron-right"></span></a>
<a class="carousel-control right" href="#myCarousel"
data-slide="next">›</a>
</div>
Essayez-le »
Le résultat est le suivant :
Légendes facultatives
Vous pouvez utiliser.itemà l'intérieur de.carousel-captionélément pour ajouter des légendes aux diapositives.
Exemple
<div id="myCarousel" class="carousel slide">
<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>
<div class="carousel-inner">
<div class="item active">
<img src="/wp-content/uploads/2014/07/slide1.png" alt="Première diapositive">
<div class="carousel-caption">Légende 1</div>
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide2.png" alt="Deuxième diapositive">
<div class="carousel-caption">Légende 2</div>
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide3.png" alt="Troisième diapositive">
<div class="carousel-caption">Légende 3</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">Précédent</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">Suivant</span>
</a>
</div>
Essayez-le »
Le résultat est le suivant :
Utilisation
Options
Certaines options sont passées via des attributs de données ou JavaScript. Le tableau suivant liste ces options :
| Nom de l'option | Type/Valeur par défaut | Nom de l'attribut de données | Description |
| interval | nombre Par défaut : 5000 | data-interval | Le délai entre le défilement automatique des éléments, ou false, pour désactiver le défilement automatique des éléments. |
| ⟦0⟧ | string Par défaut : "" | data-pause | Met en pause le défilement du carrousel lorsque la souris entre, et reprend le défilement du carrousel lorsque la souris quitte. |
| wrap | booléen Par défaut : true | data-wrap | Indique si le carrousel défile en continu. |
Méthodes
Voici quelques méthodes utiles du plugin Carousel :
| Méthode | Description | Exemple |
| .carousel(options) | Initialise le carrousel avec un objet d'options facultatif et démarre le défilement des éléments. |
$('#identifier').carousel({
interval: 2000
})
|
| .carousel('cycle') | Fait défiler les éléments du carrousel de gauche à droite. |
$('#identifier').carousel('cycle')
|
| .carousel('pause') | Arrête le défilement des éléments du carrousel. |
$('#identifier').carousel('pause') |
| .carousel(number) | Fait défiler le carrousel jusqu'à une image particulière (le comptage commence à 0, comme pour un tableau). |
$('#identifier').carousel(number) |
| .carousel('prev') | Fait défiler le carrousel jusqu'à l'élément précédent. |
$('#identifier').carousel('prev') |
| .carousel('next') | Fait défiler le carrousel jusqu'à l'élément suivant. |
$('#identifier').carousel('next') |
Exemple
L'exemple suivant illustre l'utilisation des méthodes :
Exemple
<div id="myCarousel" class="carousel slide">
<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>
<div class="carousel-inner">
<div class="item active">
<img src="/wp-content/uploads/2014/07/slide1.png" alt="Première diapositive">
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide2.png" alt="Deuxième diapositive">
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide3.png" alt="Troisième diapositive">
</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">Précédent</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">Suivant</span>
</a>
<div style="text-align:center;">
<input type="button" class="btn start-slide" value="Démarrer">
<input type="button" class="btn pause-slide" value="Pause">
<input type="button" class="btn prev-slide" value="Diapositive précédente">
<input type="button" class="btn next-slide" value="Diapositive suivante">
<input type="button" class="btn slide-one" value="Diapositive 1">
<input type="button" class="btn slide-two" value="Diapositive 2">
<input type="button" class="btn slide-three" value="Diapositive 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>
Essayez-le »
Le résultat est le suivant :
Événements
Le tableau suivant répertorie les événements utilisés dans le plugin Carousel. Ces événements peuvent être utilisés comme hooks dans les fonctions.
| Événement | Description | Exemple |
| slide.bs.carousel | Cet événement est déclenché immédiatement lorsque la méthode d'instance slide est appelée. |
$('#identifier').on('slide.bs.carousel', function () {
// 执行一些动作...
})
|
| slid.bs.carousel | Cet événement est déclenché lorsque le Carousel termine l'effet de transition slide. |
$('#identifier').on('slid.bs.carousel', function () {
// 执行一些动作...
})
|
Exemple
L'exemple suivant montre l'utilisation des événements :
Exemple
<div id="myCarousel" class="carousel slide">
<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>
<div class="carousel-inner">
<div class="item active">
<img src="/wp-content/uploads/2014/07/slide1.png" alt="Première diapositive">
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide2.png" alt="Deuxième diapositive">
</div>
<div class="item">
<img src="/wp-content/uploads/2014/07/slide3.png" alt="Troisième diapositive">
</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">Précédent</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">Suivant</span>
</a>
</div>
<script>
$(function(){
$('#myCarousel').on('slide.bs.carousel', function () {
alert("Cet événement est déclenché immédiatement lorsque la méthode d'instance slide est appelée.");
});
});
</script>
Essayez-le »
Le résultat est le suivant :
Autres extensions