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 :

    折叠面板
    1. data-toggle="collapse"Ajoutez-le au lien du composant que vous souhaitez développer ou réduire.
    2. hrefoudata-targetL'attribut est ajouté au composant parent, et sa valeur est l'id du composant enfant。
    3. 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 :

ClasseDescriptionExemple
.collapseMasque le contenu.Essayez-le
.collapse.inAffiche le contenu.Essayez-le
.collapsingAjouté 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'optionType/Valeur par défautNom de l'attribut de donnéesDescription
parentselector
Par défaut : false
data-parentSi 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.
togglebooléen
Par défaut : true
data-toggleBascule l'élément réductible lors de l'invocation.

Méthodes

Voici quelques méthodes utiles du plugin Collapse :

MéthodeDescriptionExemple
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

<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évelopper, cliquez à nouveau pour réduire. Partie 1 -- méthode hide</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-success"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseTwo">Cliquez pour développer, cliquez à nouveau pour réduire. Partie 2 -- méthode show</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-info"> <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 -- méthode toggle</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 class="panel panel-warning"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseFour">Cliquez pour développer, cliquez à nouveau pour réduire. Partie 4 -- méthode options</a> </h4> </div> <div id="collapseFour" 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> <script>
$(function () { $('#collapseFour').collapse({ toggle: false })}); $(function () { $('#collapseTwo').collapse('show')}); $(function () { $('#collapseThree').collapse('toggle')}); $(function () { $('#collapseOne').collapse('hide')});
</script>

Essayez-le vous-même »

Le résultat est affiché ci-dessous :

折叠(Collapse)插件方法

É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énementDescriptionExemple
show.bs.collapseCet événement est déclenché après l'appel de la méthode show.
$('#identifier').on('show.bs.collapse', function () {
    // 执行一些动作...
})
shown.bs.collapseCet é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.collapseCet é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.collapseCet é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

<div class="panel-group" id="accordion"> <div class="panel panel-info"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseexample">Cliquez ici pour développer, cliquez à nouveau pour réduire. -- événement shown</a> </h4> </div> <div id="collapseexample" 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> <script>
$(function () { $('#collapseexample').on('show.bs.collapse', function () { alert('Hé, cet avertissement sera affiché lorsque vous développez.');}) });
</script>

Essayez-le vous-même »

Le résultat est affiché ci-dessous :

折叠(Collapse)插件事件
Autres extensions