Bootstrap Collapse Plugin
Le plugin Collapse facilite le repli des zones de page. Que vous l'utilisiez pour créer une navigation repliable ou des panneaux de contenu, il permet de nombreuses options de contenu.
Si vous souhaitez référencer individuellement les fonctionnalités de ce plugin, vous devez référencercollapse.js. De plus, dans votre version de Bootstrap, vous devez référencer leplugin Transition. Ou, commeAperçu des plugins Bootstrapcomme mentionné dans le chapitre, vous pouvez référencerbootstrap.jsou la version compressée debootstrap.min.js。
- Créez des groupes repliables ou des accordéons, comme indiqué ci-dessous :
Exemple
<div class="panel-group" id="accordion"> <div class="panel panel-default"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseOne">Cliquez pour déplier, cliquez à nouveau pour replier. Partie 1</a> </h4> </div> <div id="collapseOne" class="panel-collapse collapse in"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> <div class="panel panel-default"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseTwo">Cliquez pour déplier, cliquez à nouveau pour replier. Partie 2</a> </h4> </div> <div id="collapseTwo" class="panel-collapse collapse"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> <div class="panel panel-default"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseThree">Cliquez pour développer, cliquez à nouveau pour réduire. Partie 3</a> </h4> </div> <div id="collapseThree" class="panel-collapse collapse"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> </div>
Essayez-le »Le résultat est affiché ci-dessous :
- data-toggle="collapse"Ajoutez-le au lien du composant que vous souhaitez développer ou réduire.
- hrefoudata-targetL'attribut est ajouté au composant parent, et sa valeur est l'id du composant enfant。
- data-parentL'attribut ajoute l'id de l'accordéon au lien du composant à développer ou à réduire.
- Créez un composant réductible simple sans balisage d'accordéon, comme indiqué ci-dessous :
Exemple
<button type="button" class="btn btn-primary" data-toggle="collapse" data-target="#demo">Composant réductible simple</button> <div id="demo" class="collapse in"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div>
Essayez-le »Le résultat est affiché ci-dessous :
Comme vous pouvez le voir dans l'exemple, nous avons créé un composant réductible ; contrairement à l'accordéon, nous n'avons pas ajouté l'attributdata-parent。
Utilisation
Le tableau suivant répertorie les classes que le plugin Collapse utilise pour faire le gros du travail :
| Classe | Description | Exemple |
|---|---|---|
| .collapse | Masque le contenu. | Essayez-le |
| .collapse.in | Affiche le contenu. | Essayez-le |
| .collapsing | Ajouté lorsque la transition commence, supprimé lorsque la transition est terminée. |
Vous pouvez utiliser le plugin Collapse des deux façons suivantes :
- Via les attributs de données: Ajoutez à un élémentdata-toggle="collapse"etdata-target, cela attribue automatiquement le contrôle de l'élément repliable.data-targetL'attribut accepte un sélecteur CSS et lui appliquera l'effet de repli. Assurez-vous d'ajouter la classe à l'élément repliable.collapse. Si vous voulez qu'il soit ouvert par défaut, ajoutez une classe supplémentaire.in。
Pour ajouter une gestion de groupe de type accordéon au contrôle repliable, ajoutez l'attribut de donnéesdata-parent="#selector"。
- Via JavaScript: Vous pouvez activer la méthode collapse via JavaScript, comme indiqué ci-dessous :
$('.collapse').collapse()
Options
Certaines options peuvent être 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 |
|---|---|---|---|
| parent | selector Par défaut : false | data-parent | Si un sélecteur est fourni, lorsqu'un élément réductible est affiché, tous les autres éléments réductibles sous le parent spécifié seront fermés. Cela est similaire au comportement d'un accordéon traditionnel - cela repose sur la classe accordion-group. |
| toggle | booléen Par défaut : true | data-toggle | Bascule l'élément réductible lors de l'invocation. |
Méthodes
Voici quelques méthodes utiles du plugin Collapse :
| Méthode | Description | Exemple |
|---|---|---|
| Options : .collapse(options) | Active le contenu en tant qu'élément réductible. Accepte un objet d'options facultatif. |
$('#identifier').collapse({
toggle: false
})
|
| Basculer : .collapse('toggle') | Bascule l'affichage/le masquage des éléments réductibles. |
$('#identifier').collapse('toggle')
|
| Afficher : .collapse('show') | Afficher les éléments réductibles. |
$('#identifier').collapse('show')
|
| Masquer : .collapse('hide') | Masquer les éléments réductibles. |
$('#identifier').collapse('hide')
|
Exemple
Les exemples ci-dessous illustrent l'utilisation des méthodes :
Exemple
Essayez-le vous-même »
Le résultat est affiché ci-dessous :
Événements
Le tableau suivant répertorie les événements utilisés dans le plugin Collapse. Ces événements peuvent être utilisés comme hooks dans des fonctions.
| Événement | Description | Exemple |
|---|---|---|
| show.bs.collapse | Cet événement est déclenché après l'appel de la méthode show. |
$('#identifier').on('show.bs.collapse', function () {
// 执行一些动作...
})
|
| shown.bs.collapse | Cet événement est déclenché lorsque l'élément repliable est visible pour l'utilisateur (il attendra que la transition CSS soit terminée). |
$('#identifier').on('shown.bs.collapse', function () {
// 执行一些动作...
})
|
| hide.bs.collapse | Cet événement est déclenché immédiatement lorsque la méthode d'instance hide est appelée. |
$('#identifier').on('hide.bs.collapse', function () {
// 执行一些动作...
})
|
| hidden.bs.collapse | Cet événement est déclenché lorsque l'élément repliable est masqué pour l'utilisateur (il attendra que la transition CSS soit terminée). |
$('#identifier').on('hidden.bs.collapse', function () {
// 执行一些动作...
})
|
Exemple
Les exemples ci-dessous illustrent l'utilisation des événements :
Exemple
Essayez-le vous-même »
Le résultat est affiché ci-dessous :