Zesummebroch
Wiesselt d'Visibilitéit vum Inhalt iwwer Äre Projet mat e puer Klassen an eise JavaScript Plugins.
Wéi et funktionnéiert
Den Zesummebroch JavaScript Plugin gëtt benotzt fir Inhalt ze weisen an ze verstoppen. Knäppercher oder Anker ginn als Ausléiser benotzt, déi op spezifesch Elementer mapéiert ginn, déi Dir wiesselt. Zesummebroch vun engem Element animéiert de height
vu sengem aktuelle Wäert op 0
. Gitt wéi CSS Animatiounen handhabt, kënnt Dir net padding
op engem .collapse
Element benotzen. Amplaz benotzt d'Klass als onofhängeg Wrapelement.
prefers-reduced-motion
Medienufro of. Kuckt d'
Reduktiounsbewegungssektioun vun eiser Accessibilitéitsdokumentatioun .
Beispill
Klickt op d'Knäppercher hei ënnen fir en anert Element iwwer Klassenännerungen ze weisen an ze verstoppen:
.collapse
verstoppt Inhalt.collapsing
gëtt während Iwwergäng applizéiert.collapse.show
weist Inhalt
Allgemeng recommandéiere mir e Knäppchen mat dem data-target
Attribut ze benotzen. Obwuel net aus semantescher Siicht recommandéiert ass, kënnt Dir och e Link mam href
Attribut benotzen (an e role="button"
). A béide Fäll data-toggle="collapse"
ass et néideg.
<p>
<a class="btn btn-primary" data-toggle="collapse" href="#collapseExample" role="button" aria-expanded="false" aria-controls="collapseExample">
Link with href
</a>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#collapseExample" aria-expanded="false" aria-controls="collapseExample">
Button with data-target
</button>
</p>
<div class="collapse" id="collapseExample">
<div class="card card-body">
Some placeholder content for the collapse component. This panel is hidden by default but revealed when the user activates the relevant trigger.
</div>
</div>
Horizontal
Den Zesummebroch Plugin ënnerstëtzt och horizontal Zesummebroch. Füügt d' .width
Modifikateur Klass fir den Iwwergang width
amplaz height
a setzt en width
op dat direkt Kand Element. Fillt Iech gratis Ären eegene personaliséierte Sass ze schreiwen, benotzt Inline Stiler oder benotzt eis Breet Utilities .
min-height
Set huet fir exzessiv Repaints an eisen Dokumenter ze vermeiden, ass dëst net explizit erfuerderlech.
Nëmmen d' width
Kand Element ass néideg.
<p>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#collapseWidthExample" aria-expanded="false" aria-controls="collapseWidthExample">
Toggle width collapse
</button>
</p>
<div style="min-height: 120px;">
<div class="collapse width" id="collapseWidthExample">
<div class="card card-body" style="width: 320px;">
This is some placeholder content for a horizontal collapse. It's hidden by default and shown when triggered.
</div>
</div>
</div>
Multiple Ziler
A <button>
oder <a>
kann verschidde Elementer weisen a verstoppen andeems se se mat engem JQuery Selektor a sengem href
oder data-target
Attribut referenzéieren. Multiple <button>
oder <a>
kënnen en Element weisen a verstoppen wa se jidderee mat hirem href
oder data-target
Attribut referenzéieren
<p>
<a class="btn btn-primary" data-toggle="collapse" href="#multiCollapseExample1" role="button" aria-expanded="false" aria-controls="multiCollapseExample1">Toggle first element</a>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#multiCollapseExample2" aria-expanded="false" aria-controls="multiCollapseExample2">Toggle second element</button>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target=".multi-collapse" aria-expanded="false" aria-controls="multiCollapseExample1 multiCollapseExample2">Toggle both elements</button>
</p>
<div class="row">
<div class="col">
<div class="collapse multi-collapse" id="multiCollapseExample1">
<div class="card card-body">
Some placeholder content for the first collapse component of this multi-collapse example. This panel is hidden by default but revealed when the user activates the relevant trigger.
</div>
</div>
</div>
<div class="col">
<div class="collapse multi-collapse" id="multiCollapseExample2">
<div class="card card-body">
Some placeholder content for the second collapse component of this multi-collapse example. This panel is hidden by default but revealed when the user activates the relevant trigger.
</div>
</div>
</div>
</div>
Akkordeon Beispill
Mat der Kaart Komponente kënnt Dir d'Standard Zesummebroch Verhalen verlängeren fir en Akkordeon ze kreéieren. Fir den Akkordeonstil richteg z'erreechen, gitt sécher .accordion
als Wrapper ze benotzen.
.show
Klass.
<div class="accordion" id="accordionExample">
<div class="card">
<div class="card-header" id="headingOne">
<h2 class="mb-0">
<button class="btn btn-link btn-block text-left" type="button" data-toggle="collapse" data-target="#collapseOne" aria-expanded="true" aria-controls="collapseOne">
Collapsible Group Item #1
</button>
</h2>
</div>
<div id="collapseOne" class="collapse show" aria-labelledby="headingOne" data-parent="#accordionExample">
<div class="card-body">
Some placeholder content for the first accordion panel. This panel is shown by default, thanks to the <code>.show</code> class.
</div>
</div>
</div>
<div class="card">
<div class="card-header" id="headingTwo">
<h2 class="mb-0">
<button class="btn btn-link btn-block text-left collapsed" type="button" data-toggle="collapse" data-target="#collapseTwo" aria-expanded="false" aria-controls="collapseTwo">
Collapsible Group Item #2
</button>
</h2>
</div>
<div id="collapseTwo" class="collapse" aria-labelledby="headingTwo" data-parent="#accordionExample">
<div class="card-body">
Some placeholder content for the second accordion panel. This panel is hidden by default.
</div>
</div>
</div>
<div class="card">
<div class="card-header" id="headingThree">
<h2 class="mb-0">
<button class="btn btn-link btn-block text-left collapsed" type="button" data-toggle="collapse" data-target="#collapseThree" aria-expanded="false" aria-controls="collapseThree">
Collapsible Group Item #3
</button>
</h2>
</div>
<div id="collapseThree" class="collapse" aria-labelledby="headingThree" data-parent="#accordionExample">
<div class="card-body">
And lastly, the placeholder content for the third and final accordion panel. This panel is hidden by default.
</div>
</div>
</div>
</div>
Accessibilitéit
Vergewëssert Iech aria-expanded
d'Kontrollelement ze addéieren. Dëst Attribut vermëttelt explizit den aktuellen Zoustand vum zesummeklappbare Element, deen un d'Kontroll gebonnen ass, un Écran Lieser an ähnlech Hëllefstechnologien. Wann dat zesummeklappbare Element par défaut zougemaach ass, soll d'Attribut um Kontrollelement e Wäert vun hunn aria-expanded="false"
. Wann Dir d'Zesummeklappbar Element als Standard opgemaach hutt mat der show
Klass opzemaachen, setzt aria-expanded="true"
d'Kontroll amplaz. De Plugin wiesselt automatesch dëst Attribut op der Kontroll baséiert op ob dat zesummeklappbare Element opgemaach oder zougemaach gouf oder net (iwwer JavaScript, oder well de Benotzer en anert Kontrollelement ausgeléist huet, dat och mam selwechte zesummeklappbare Element gebonnen ass). Wann den HTML-Element vum Kontrollelement net e Knäppchen ass (zB an <a>
oder <div>
), den Attributrole="button"
soll dem Element dobäi ginn.
Wann Äert Kontrollelement op en eenzegt zesummeklappbare Element zielt - dh d' data-target
Attribut weist op e id
Selektor - Dir sollt d' aria-controls
Attribut un d'Kontrollelement addéieren, mat dem id
vum zesummeklappbare Element. Modern Bildschirm Lieser an ähnlech Hëllefstechnologien benotzen dësen Attribut fir Benotzer zousätzlech Ofkiirzungen ze bidden fir direkt op dat zesummeklappbare Element selwer ze navigéieren.
Notéiert datt déi aktuell Implementatioun vum Bootstrap déi verschidde Tastaturinteraktiounen net ofdeckt, déi am ARIA Authoring Practices Guide Akkordeonmuster beschriwwe sinn - Dir musst dës selwer mat personaliséierten JavaScript enthalen.
Benotzung
Den Zesummebroch Plugin benotzt e puer Klassen fir déi schwéier Lift ze handhaben:
.collapse
verstoppt den Inhalt.collapse.show
weist den Inhalt.collapsing
gëtt bäigefüügt wann den Iwwergank ufänkt, a geläscht wann et fäerdeg ass
Dës Klassen kënnen an fonnt ginn _transitions.scss
.
Via daten Attributer
Füügt einfach data-toggle="collapse"
an en data-target
un d'Element fir automatesch Kontroll vun engem oder méi zesummeklappbare Elementer ze ginn. D' data-target
Attribut akzeptéiert e CSS Selektor fir den Zesummebroch anzebezéien. Vergewëssert Iech d'Klass collapse
zum zesummeklappbare Element ze addéieren. Wann Dir wëllt datt et als Standard opmaacht, füügt déi zousätzlech Klass show
.
Fir Akkordeonähnlech Gruppemanagement zu engem zesummeklappbare Gebitt ze addéieren, füügt d'Datenattribut data-parent="#selector"
. Kuckt d'Demo fir dëst an Aktioun ze gesinn.
Iwwer JavaScript
Aktivéiert manuell mat:
$('.collapse').collapse()
Optiounen
Optiounen kënnen iwwer Datenattributer oder JavaScript weidergeleet ginn. Fir Datenattributer, fügen d'Optiounsnumm un data-
, wéi an data-parent=""
.
Numm | Typ | Default | Beschreiwung |
---|---|---|---|
Elterendeel | selector | jQuery Objet | DOM Element | falsch | Wann Elterendeel gëtt, da ginn all zesummeklappbar Elementer ënner dem spezifizéierten Elterendeel zougemaach wann dësen zesummeklappbare Element gewise gëtt. (ähnlech wéi traditionell Akkordeonverhalen - dëst hänkt vun der card Klass of). D'Attributer muss op der Zil- zesummeklappbare Beräich gesat ginn. |
wiesselen | boolesch | wouer | Wiesselt dat zesummeklappbare Element op Uruff |
Methoden
Asynchron Methoden an Iwwergäng
All API Methoden sinn asynchron a starten en Iwwergang . Si ginn zréck op den Uruffer soubal den Iwwergang ugefaang ass, awer ier en eriwwer ass . Zousätzlech gëtt e Methodruff op eng Iwwergangskomponent ignoréiert .
.collapse(options)
Aktivéiert Ären Inhalt als zesummeklappbar Element. Akzeptéiert eng fakultativ Optiounen object
.
$('#myCollapsible').collapse({
toggle: false
})
.collapse('toggle')
Wiesselt en zesummeklappbare Element fir ze weisen oder verstoppt. Gitt zréck op den Uruffer ier dat zesummeklappbare Element tatsächlech gewisen oder verstoppt gouf (dh ier d' Evenement shown.bs.collapse
oder hidden.bs.collapse
geschitt).
.collapse('show')
Weist en zesummeklappbare Element. Zréck op den Uruffer ier dat zesummeklappbare Element tatsächlech gewisen gouf (dh ier d' shown.bs.collapse
Evenement geschitt ass).
.collapse('hide')
Verstoppt en zesummeklappbare Element. Gitt zréck op den Uruffer ier dat zesummeklappbare Element tatsächlech verstoppt gouf (dh ier d' hidden.bs.collapse
Evenement geschitt ass).
.collapse('dispose')
Zerstéiert den Zesummebroch vun engem Element.
Evenementer
Dem Bootstrap seng Zesummebroch Klass weist e puer Eventer fir an d'Zesummefunktionalitéit unzehaken.
Event Typ | Beschreiwung |
---|---|
show.bs.Zesummebroch | Dëst Event brennt direkt wann d' show Instanzmethod genannt gëtt. |
gewisen.bs.Zesummebroch | Dëst Evenement gëtt ausgeléist wann e Zesummebroch Element fir de Benotzer siichtbar gemaach gouf (waart bis CSS Iwwergäng fäerdeg sinn). |
hide.bs.collapse | Dëst Evenement gëtt direkt gebrannt wann d' hide Method genannt gouf. |
hidden.bs.zesummebroch | Dëst Evenement gëtt ausgeléist wann en Zesummebroch Element vum Benotzer verstoppt ass (waart op CSS Iwwergäng fir fäerdeg ze maachen). |
$('#myCollapsible').on('hidden.bs.collapse', function () {
// do something...
})