Chim
I project pumpui chhunga content hmuh theihna chu class tlemte leh kan JavaScript plugins hmangin toggle rawh.
A hnathawh dan
Collapse JavaScript plugin hi content entir leh thup nan hman a ni. Button emaw anchor emaw hi trigger atan hman a ni a, chu chu element bik i toggle-naah mapped a ni. Element pakhat collapse chuan a height
value awm mek atanga 0
. CSS hian animation a enkawl dan ngaihtuah chuan element padding
pakhatah i hmang thei lo. .collapse
Chu ai chuan class chu independent wrapping element atan hmang zawk ang che.
prefers-reduced-motion
media query ah a innghat a ni. Kan accessibility documentation a reduced motion tih hi en la
.
Entirna
A hnuaia button te hi click la, class thlak danglam hmangin element dang a lantir leh thup ang:
.collapse
content a thup thin.collapsing
transition neih laiin hman a ni.collapse.show
thupui a lantir
data-bs-target
A tlangpuiin attribute nei button hman kan rawt a ni. Semantic point of view atanga recommend loh laiin, href
attribute (leh a role="button"
) nei link pawh i hmang thei bawk. Heng pahnihah hian the data-bs-toggle="collapse"
is required.
<p>
<a class="btn btn-primary" data-bs-toggle="collapse" href="#collapseExample" role="button" aria-expanded="false" aria-controls="collapseExample">
Link with href
</a>
<button class="btn btn-primary" type="button" data-bs-toggle="collapse" data-bs-target="#collapseExample" aria-expanded="false" aria-controls="collapseExample">
Button with data-bs-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>
Target tam tak a awm
A <button>
or hian element tam tak chu a or attribute <a>
-a selector hmanga reference-in a lantir thei a, a thup thei bawk. Multiple emaw element pakhat chu an or attribute hmanga an reference vek chuan an lantir thei a, an thup thei bawkhref
data-bs-target
<button>
<a>
href
data-bs-target
Element hmasa ber chu toggle rawh
<p>
<a class="btn btn-primary" data-bs-toggle="collapse" href="#multiCollapseExample1" role="button" aria-expanded="false" aria-controls="multiCollapseExample1">Toggle first element</a>
<button class="btn btn-primary" type="button" data-bs-toggle="collapse" data-bs-target="#multiCollapseExample2" aria-expanded="false" aria-controls="multiCollapseExample2">Toggle second element</button>
<button class="btn btn-primary" type="button" data-bs-toggle="collapse" data-bs-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>
A thlen theihna tur
aria-expanded
Control element ah hian add ngei ngei tur a ni. He attribute hian control-a inzawm collapsible element dinhmun chu screen reader leh a ang chi assistive technology-ah chiang takin a tarlang a ni. Collapsible element chu default-a khar a nih chuan control element-a attribute chuan value aria-expanded="false"
. show
Class hmangin collapsible element chu default-a open turin i set tawh a nih chuan aria-expanded="true"
control-ah set zawk rawh. Plugin hian he attribute hi control-ah hian collapsible element hawn leh khar a nih leh nih loh a zirin automatic-in a toggle ang (JavaScript hmangin, emaw, user-in control element dang pawh collapsible element ang chiaha inzawm a trigger avangin). Control element-a HTML element chu button a nih loh chuan (eg, an <a>
or <div>
), attributerole="button"
element-ah hian dah belh tur a ni.
I control element hian collapsible element pakhat a target a nih chuan – chu chu attribute chuan selector data-bs-target
a kawhhmuh a nih chuan – control element-ah attribute chu i dah tur a ni a, chutah chuan of the collapsible element a awm tur a ni. Tunlai screen reader leh a ang chi assistive technology te chuan he attribute hi an hmang a, chu chuan a hmangtute chu collapsible element ngeia direct-a kal theihna tur shortcut dang a pe a ni.id
aria-controls
id
Bootstrap hman mek hian WAI-ARIA Authoring Practices 1.1 accordion pattern- a tarlan optional keyboard interaction hrang hrangte chu a huam lo tih hre reng ang che - hengte hi nangmah ngeiin custom JavaScript nen i dah tel a ngai ang.
Sass a ni
Variables te pawh a awm
$transition-collapse: height .35s ease;
Class hrang hrang te
scss/_transitions.scss
Hengte hi component hrang hrang (collapse leh accordion) hrang hranga an insem avangin collapse transition class te hi hmuh theih a ni .
.collapse {
&:not(.show) {
display: none;
}
}
.collapsing {
height: 0;
overflow: hidden;
@include transition($transition-collapse);
}
Hman dan tur
Collapse plugin hian heavy lifting handle turin class tlemte a hmang a:
.collapse
a thupui chu a thup thin.collapse.show
a thupui chu a entir a.collapsing
transition a tan hunah a dah belh a, a zawh chuan a paih leh bawk
Heng class te hi _transitions.scss
.
Data attribute hmangin a ni
Element ah add data-bs-toggle="collapse"
leh a data-bs-target
tih mai la, collapsible element pakhat emaw a aia tam emaw control chu automatic in a assign ang. Attribute hian data-bs-target
collapse apply tur CSS selector a pawm a. collapse
Collapsible element ah hian class chu add ngei ngei tur a ni. Default open i duh chuan additional class kha add la show
.
Collapsible area-a accordion ang chi group management dah belh tur chuan data attribute data-bs-parent="#selector"
. Hei hi action-a hmuh theih nan demo en rawh.
JavaScript hmangin
Manual hmangin enable theih a ni:
var collapseElementList = [].slice.call(document.querySelectorAll('.collapse'))
var collapseList = collapseElementList.map(function (collapseEl) {
return new bootstrap.Collapse(collapseEl)
})
Thil thlan theih a ni
Options chu data attribute emaw JavaScript hmangin pass theih a ni. Data attribute atan chuan option hming chu , ah hian append la data-bs-
, data-bs-parent=""
.
Hming | Lampang | Hlawhchhamna | Hrilhfiahna |
---|---|---|---|
parent |
thlangtu | jQuery thil awmzia | DOM element a ni | false |
Parent pek a nih chuan he collapsible item hi a lan hunah parent tarlan hnuaia collapsible element zawng zawng chu khar vek a ni ang. card (traditional accordion behavior nen a inang - hei hi class -ah a innghat ). Attribute chu target collapsible area-ah set a ngai a ni. |
toggle |
boolean a ni | true |
Invocation-ah collapsible element a toggle thin |
Thiltih dan tur
Asynchronous method leh inthlak danglamna te
API method zawng zawng hi asynchronous a ni a , transition a tan vek a ni . Transition an tan veleh mahse a tawp hmain call tu hnenah an kir leh thin . Chu bakah, transitioning component-a method call chu ngaihthah a ni ang .
I content chu collapsible element angin a activate thin. A pawm a, optional options a awm object
bawk .
Constructor hmangin collapse instance i siam thei a, entirnan:
var myCollapse = document.getElementById('myCollapse')
var bsCollapse = new bootstrap.Collapse(myCollapse, {
toggle: false
})
Tihdan | Hrilhfiahna |
---|---|
toggle |
Collapsible element chu show emaw hidden emaw ah a toggle thin. Collapsible element chu a takin a lan hma emaw a thup hmain (chu chu shown.bs.collapse or hidden.bs.collapse event a thlen hmain) caller hnenah a kir leh thin. |
show |
Collapsible element a lantir. Collapsible element a lan tak tak hmain (eg, shown.bs.collapse event a thlen hmain) caller hnenah a kir leh thin. |
hide |
Collapsible element a thup thei. Collapsible element chu thup tak tak a nih hmain (eg, hidden.bs.collapse event a thlen hmain) caller hnenah a kir leh thin. |
dispose |
Element pakhat collapse a tichhe thin. (DOM element-a data dahkhawmte a paih chhuak) |
getInstance |
Static method hmanga DOM element nena inzawm collapse instance hmuh theihna tur, hetiang hian i hmang thei ang:bootstrap.Collapse.getInstance(element) |
getOrCreateInstance |
Static method chu DOM element nena inzawm collapse instance rawn pe chhuak emaw, initialised a nih loh chuan a thar siam emaw a ni. Hetiang hian i hmang thei ang:bootstrap.Collapse.getOrCreateInstance(element) |
Thil thlengte
Bootstrap-a collapse class hian collapse functionality-a hook theihna tur event tlemte a pholang a ni.
Event chi hrang hrang | Hrilhfiahna |
---|---|
show.bs.collapse |
show He event hi instance method kan koh chuan a fire nghal vek a ni. |
shown.bs.collapse |
He event hi collapse element pakhat user hmuh theiha siam a nih chuan fired a ni (CSS transition zawh hun a nghak ang). |
hide.bs.collapse |
hide He event hi method koh a nih chuan a fire nghal a ni. |
hidden.bs.collapse |
He event hi user hnen atanga collapse element thup a nih chuan a fire thin (CSS transition zawh hun a nghak ang). |
var myCollapsible = document.getElementById('myCollapsible')
myCollapsible.addEventListener('hidden.bs.collapse', function () {
// do something...
})