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"> <!--Indicateurs du carrousel--> <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> <!--Éléments du carrousel--> <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> <!--Navigation du carrousel--> <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">&rsaquo;</a> </div>

Essayez-le »

Le résultat est le suivant :

简单的轮播(Carousel)插件

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"> <!--Indicateurs du carrousel--> <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> <!--Éléments du carrousel--> <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> <!--Navigation du carrousel--> <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 :

轮播(Carousel)插件的标题

Utilisation

  • Via les attributs data: L'utilisation des attributs data facilite le contrôle de la position du carrousel.
    • L'attributdata-slideaccepte le mot-cléprevounext, utilisé pour modifier la position de la diapositive par rapport à sa position actuelle.
    • Utilisezdata-slide-topour transmettre un index de diapositive brut au carrousel,data-slide-to="2"ce qui déplace le carrousel vers un index spécifique, l'indexation commençant à 0.
    • data-ride="carousel"L'attribut est utilisé pour indiquer que le carrousel commence à s'animer au chargement de la page.
  • Via JavaScript: Le carrousel peut être invoqué manuellement via JavaScript, comme indiqué ci-dessous :
    $('.carousel').carousel()
    

Options

Certaines options sont passées via des attributs de données ou JavaScript. Le tableau suivant liste ces options :

Nom de l'optionType/Valeur par défautNom de l'attribut de donnéesDescription
intervalnombre
Par défaut : 5000
data-intervalLe 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-pauseMet en pause le défilement du carrousel lorsque la souris entre, et reprend le défilement du carrousel lorsque la souris quitte.
wrapbooléen
Par défaut : true
data-wrapIndique si le carrousel défile en continu.

Méthodes

Voici quelques méthodes utiles du plugin Carousel :

MéthodeDescriptionExemple
.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"> <!--Indicateurs du carrousel--> <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> <!--Éléments du carrousel--> <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> <!--Navigation du carrousel--> <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> <!--Boutons de contrôle--> <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(){ //Initialiser le carrousel $(".start-slide").click(function(){ $("#myCarousel").carousel('cycle'); }); //Arrêter le carrousel $(".pause-slide").click(function(){ $("#myCarousel").carousel('pause'); }); //Passer à l'élément précédent $(".prev-slide").click(function(){ $("#myCarousel").carousel('prev'); }); //Passer à l'élément suivant $(".next-slide").click(function(){ $("#myCarousel").carousel('next'); }); //Passer à une image spécifique $(".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 :

轮播(Carousel)插件方法

É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énementDescriptionExemple
slide.bs.carouselCet é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.carouselCet é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"> <!--Indicateurs du carrousel--> <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> <!--Éléments du carrousel--> <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> <!--Navigation du carrousel--> <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 :

轮播(Carousel)插件事件
Autres extensions