Bootstrap Collapse Plugin

Das Collapse-Plugin erleichtert das Zusammenklappen von Seitenbereichen. Ob Sie es für aufklappbare Navigationen oder Inhaltsbereiche verwenden, es bietet zahlreiche Inhaltsoptionen.

Wenn Sie auf die Funktionalität dieses Plugins einzeln verweisen möchten, müssen Siecollapse.jseinbinden. Außerdem müssen Sie in Ihrer Bootstrap-Version dasTransition-Plugin einbindenOder, wie im KapitelBootstrap-Plugin-Übersichterwähnt, können Siebootstrap.jsoder die komprimierte Versionbootstrap.min.js。

  • Erstellen Sie aufklappbare Gruppen oder Akkordeons, wie unten gezeigt:

    Beispiel

    <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">Klicken Sie hier zum Ausklappen, nochmals klicken zum Einklappen. Teil 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">Klicken Sie hier zum Ausklappen, nochmals klicken zum Einklappen. Teil 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">Klicken Sie hier zum Ausklappen, nochmals klicken zum Einklappen. Teil 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>

    Ausprobieren »

    Das Ergebnis wird unten angezeigt:

    折叠面板
    1. data-toggle="collapse"Wird dem Link der Komponente hinzugefügt, die Sie ein- oder ausklappen möchten.
    2. hrefoderdata-targetDas Attribut wird der übergeordneten Komponente hinzugefügt, und sein Wert ist dieid。
    3. data-parentDas Attribut fügt die ID des Akkordeons dem Link der ein- oder auszuklappenden Komponente hinzu.
  • Erstellen Sie eine einfache aufklappbare Komponente ohne Akkordeon-Markup, wie unten gezeigt:

    Beispiel

    <button type="button" class="btn btn-primary" data-toggle="collapse" data-target="#demo">Einfache aufklappbare Komponente</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>

    Ausprobieren »

    Das Ergebnis wird unten angezeigt:

    简单的可折叠组件

    Wie Sie im Beispiel sehen können, haben wir eine aufklappbare Komponente erstellt; im Gegensatz zum Akkordeon haben wir das Attributdata-parent。

Nutzung

Die folgende Tabelle listet die Klassen auf, die das Collapse-Plugin für die Kernfunktionen verwendet:

KlasseBeschreibungBeispiel
.collapseBlendet den Inhalt aus.Ausprobieren
.collapse.inZeigt den Inhalt an.Ausprobieren
.collapsingWird hinzugefügt, wenn der Übergang beginnt, und entfernt, wenn der Übergang abgeschlossen ist. 

Sie können das Collapse-Plugin auf die folgenden zwei Arten verwenden:

  • Über Datenattribute: Fügen Sie einem Elementdata-toggle="collapse"unddata-targethinzu, um die Steuerung des aufklappbaren Elements automatisch zuzuweisen.data-targetDas Attribut akzeptiert einen CSS-Selektor und wendet den Ein-/Ausklapp-Effekt darauf an. Stellen Sie sicher, dass Sie dem aufklappbaren Element die Klasse.collapsehinzufügen. Wenn es standardmäßig geöffnet sein soll, fügen Sie die zusätzliche Klasse.in。

    Um der Aufklappsteuerung eine Akkordeon-artige Gruppenverwaltung hinzuzufügen, fügen Sie das Datenattributdata-parent="#selector"。

  • Über JavaScript: Sie können die collapse-Methode über JavaScript aktivieren, wie unten gezeigt:
    $('.collapse').collapse()
    

Optionen

Einige Optionen können über Datenattribute oder JavaScript übergeben werden. Die folgende Tabelle listet diese Optionen auf:

OptionsnameTyp / StandardwertDatenattribut-NameBeschreibung
parentselector
Standard: false
data-parentWenn ein Selektor angegeben wird, werden beim Anzeigen eines aufklappbaren Elements alle anderen aufklappbaren Elemente unter dem angegebenen übergeordneten Element geschlossen. Dies entspricht dem Verhalten eines traditionellen Akkordeons – es stützt sich auf die Akkordeon-Gruppenklasse.
toggleboolesch
Standard: true
data-toggleSchaltet das aufklappbare Element beim Aufruf um.

Methoden

Unten sind einige nützliche Methoden des Collapse-Plugins aufgeführt:

MethodeBeschreibungBeispiel
Optionen: .collapse(options)Aktiviert den Inhalt als aufklappbares Element. Akzeptiert ein optionales Optionen-Objekt.
$('#identifier').collapse({
    toggle: false
})
Umschalten: .collapse('toggle')Schaltet die Anzeige für aufklappbare Elemente ein/aus.
$('#identifier').collapse('toggle')
Anzeigen: .collapse('show')Zeigt aufklappbare Elemente an.
$('#identifier').collapse('show')
Ausblenden: .collapse('hide')Blendet aufklappbare Elemente aus.
$('#identifier').collapse('hide')

Beispiel

Die folgenden Beispiele demonstrieren die Verwendung der Methoden:

Beispiel

<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">Klicken Sie hier zum Ausklappen, nochmals klicken zum Einklappen. Teil 1 -- hide-Methode</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">Klicken Sie hier zum Ausklappen, nochmals klicken zum Einklappen. Teil 2 -- show-Methode</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">Klicken Sie hier zum Ausklappen, nochmals klicken zum Einklappen. Teil 3 -- toggle-Methode</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">Klicken Sie hier zum Ausklappen, nochmals klicken zum Einklappen. Teil 4 -- options-Methode</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>

Selbst ausprobieren »

Das Ergebnis wird unten angezeigt:

折叠(Collapse)插件方法

Ereignisse

Die folgende Tabelle listet die im Collapse-Plugin verwendeten Ereignisse auf. Diese Ereignisse können als Hooks in Funktionen verwendet werden.

EreignisBeschreibungBeispiel
show.bs.collapseDieses Ereignis wird ausgelöst, nachdem die Methode show aufgerufen wurde.
$('#identifier').on('show.bs.collapse', function () {
    // 执行一些动作...
})
shown.bs.collapseDieses Ereignis wird ausgelöst, wenn das zusammenklappbare Element für den Benutzer sichtbar ist (es wartet, bis der CSS-Übergang abgeschlossen ist).
$('#identifier').on('shown.bs.collapse', function () {
    // 执行一些动作...
})
hide.bs.collapseDieses Ereignis wird sofort ausgelöst, wenn die Instanzmethode hide aufgerufen wird.
$('#identifier').on('hide.bs.collapse', function () {
    // 执行一些动作...
})
hidden.bs.collapseDieses Ereignis wird ausgelöst, wenn das zusammenklappbare Element für den Benutzer ausgeblendet ist (es wartet, bis der CSS-Übergang abgeschlossen ist).
$('#identifier').on('hidden.bs.collapse', function () {
    // 执行一些动作...
})

Beispiel

Die folgenden Beispiele demonstrieren die Verwendung der Ereignisse:

Beispiel

<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">Klicken Sie hier zum Ausklappen, nochmals klicken zum Einklappen. -- shown-Ereignis</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('Hey, diese Warnung wird beim Ausklappen angezeigt.');}) });
</script>

Selbst ausprobieren »

Das Ergebnis wird unten angezeigt:

折叠(Collapse)插件事件
Andere Erweiterungen