Gusenyuka
Kuzuza ibiboneka mumushinga wawe hamwe namasomo make hamwe na plugin yacu ya JavaScript.
Uburyo ikora
Gusenyuka JavaScript plugin ikoreshwa mukwerekana no guhisha ibirimo. Utubuto cyangwa inanga zikoreshwa nka trigger zashizwe kumurongo wihariye uhinduranya. Gusenyuka ikintu kizashushanya i height
kuva agaciro kayo kugeza 0
. Urebye uburyo CSS ikora animasiyo, ntushobora gukoresha padding
kubintu .collapse
. Ahubwo, koresha urwego nkibintu byigenga bipfunyika.
prefers-reduced-motion
nibibazo byitangazamakuru. Reba igice
cyagabanijwe cyicyiciro cyibisobanuro byacu .
Urugero
Kanda buto hepfo kugirango werekane kandi uhishe ikindi kintu ukoresheje impinduka zamasomo:
.collapse
ahisha ibirimo.collapsing
ni Byakoreshejwe Mugihe Cyinzibacyuho.collapse.show
yerekana ibirimo
Mubisanzwe, turasaba gukoresha buto ifite data-bs-target
ikiranga. Mugihe udasabwe kuva mubisobanuro, urashobora kandi gukoresha umurongo hamwe na href
kiranga (na a role="button"
). Muri ibyo bihe byombi, data-bs-toggle="collapse"
urasabwa.
<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>
Uhagaritse
Gusenyuka plugin nayo ishyigikira gutambuka gutambitse. Ongeraho .collapse-horizontal
icyiciro cyo guhindura kugirango uhindure width
aho kugirango height
ushireho ikintu width
cyumwana uhita. Wumve neza ko wanditse Sass yawe yihariye, koresha inline, cyangwa ukoreshe ubugari bwacu .
min-height
yo kwirinda gusiga irangi muri docs, ibi ntabwo bisabwa neza.
Gusa width
ibyingenzi kumwana birakenewe.
<p>
<button class="btn btn-primary" type="button" data-bs-toggle="collapse" data-bs-target="#collapseWidthExample" aria-expanded="false" aria-controls="collapseWidthExample">
Toggle width collapse
</button>
</p>
<div style="min-height: 120px;">
<div class="collapse collapse-horizontal" id="collapseWidthExample">
<div class="card card-body" style="width: 300px;">
This is some placeholder content for a horizontal collapse. It's hidden by default and shown when triggered.
</div>
</div>
</div>
Intego nyinshi
A <button>
cyangwa <a>
irashobora kwerekana no guhisha ibintu byinshi mubohereza hamwe nuwatoranije muri href
cyangwa data-bs-target
ikiranga. Igwije <button>
cyangwa irashobora kwerekana no <a>
guhisha ikintu niba buriwese abigaragaza hamwe nibirangahref
data-bs-target
<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>
Kuboneka
Witondere kongera aria-expanded
kubintu bigenzura. Iyi miterere yerekana neza uko ibintu bimeze ubu ibintu byangirika bifitanye isano no kugenzura abasomyi hamwe na tekinoroji ifasha. Niba ikintu gishobora gusenyuka gifunzwe byanze bikunze, ikiranga kugenzura ikintu kigomba kugira agaciro ka aria-expanded="false"
. Niba washyizeho ikintu gishobora kugwa kugirango ufungure byanze bikunze ukoresheje urwego show
, shyira aria-expanded="true"
kugenzura aho. Gucomeka izahita ihindura iyi miterere kubigenzuzi ukurikije niba ikintu gishobora kugwa cyarafunguwe cyangwa kidafunzwe (binyuze kuri JavaScript, cyangwa kubera ko umukoresha yatangije ikindi kintu cyo kugenzura nacyo kijyanye nibintu bimwe bishobora kugwa). Niba igenzura ryibintu bya HTML ntabwo ari buto (urugero, an <a>
cyangwa <div>
), ikirangarole="button"
bigomba kongerwaho kubintu.
Niba igikoresho cyawe cyo kugenzura kireba ikintu kimwe gishobora gusenyuka - ni ukuvuga data-bs-target
ikiranga cyerekana id
uwatoranije - ugomba kongeramo aria-controls
ikiranga kubintu bigenzura, bikubiyemo id
ibintu byangirika. Abasomyi ba kijyambere bigezweho hamwe nubuhanga busa bufasha gukoresha iyi miterere kugirango batange abakoresha ama shortcuts yinyongera kugirango bayobore neza kubintu byangirika ubwabyo.
Menya ko Bootstrap ishyirwa mubikorwa muri iki gihe ntabwo ikubiyemo imikoranire itandukanye ya clavier yasobanuwe muburyo bwa WAI-ARIA bwo Kwandika 1.1 uburyo bwa bordion - uzakenera kubishyiramo ubwawe hamwe na JavaScript yihariye.
Sass
Ibihinduka
$transition-collapse: height .35s ease;
$transition-collapse-width: width .35s ease;
Amasomo
Gusenyuka ibyiciro byinzibacyuho murashobora kubisanga scss/_transitions.scss
nkuko bisangiwe mubice byinshi (gusenyuka na bordion).
.collapse {
&:not(.show) {
display: none;
}
}
.collapsing {
height: 0;
overflow: hidden;
@include transition($transition-collapse);
&.collapse-horizontal {
width: 0;
height: auto;
@include transition($transition-collapse-width);
}
}
Ikoreshwa
Gusenyuka plugin ikoresha ibyiciro bike kugirango ikemure ibintu biremereye:
.collapse
ahisha ibirimo.collapse.show
yerekana ibirimo.collapsing
yongeweho iyo inzibacyuho itangiye, ikanakurwaho iyo irangiye
Aya masomo murayasanga muri _transitions.scss
.
Binyuze mu biranga amakuru
Gusa ongeraho data-bs-toggle="collapse"
na a data-bs-target
kubintu kugirango uhite ugenera kugenzura ikintu kimwe cyangwa byinshi bishobora gusenyuka. Ikiranga data-bs-target
cyakira CSS uhitamo kugirango akoreshe gusenyuka kuri. Wemeze kongeramo urwego collapse
kubintu bishobora kugwa. Niba wifuza ko byafungura, ongeraho urwego rwinyongera show
.
Kugirango wongere imiyoborere isa nitsinda ryubuyobozi ahantu hashobora gusenyuka, ongeramo amakuru ikiranga data-bs-parent="#selector"
. Reba kurupapuro rwabigenewe kugirango ubone ibisobanuro byinshi.
Binyuze kuri JavaScript
Gushoboza intoki hamwe na:
var collapseElementList = [].slice.call(document.querySelectorAll('.collapse'))
var collapseList = collapseElementList.map(function (collapseEl) {
return new bootstrap.Collapse(collapseEl)
})
Amahitamo
Amahitamo arashobora kunyuzwa kumurongo wamakuru cyangwa JavaScript. Kubiranga Ibyatanzwe, Ongeraho Ihitamo Izina Kuri data-bs-
, Nka Muri data-bs-parent=""
.
Izina | Andika | Mburabuzi | Ibisobanuro |
---|---|---|---|
parent |
uwatoranije | Ikintu cyibibazo | Ikintu cya DOM | false |
Niba umubyeyi atanzwe, noneho ibintu byose bishobora gusenyuka munsi yumubyeyi wabigenewe bizafungwa mugihe iki kintu gishobora kugwa. (bisa nimyitwarire ya gakondo ya gakondo - ibi biterwa card nurwego). Ikiranga kigomba gushyirwaho ku ntego ishobora kugwa. |
toggle |
boolean | true |
Kuzuza ibintu bishobora kugwa kuri invocation |
Uburyo
Uburyo butajegajega ninzibacyuho
Inzira zose za API ntizihuza kandi zitangira inzibacyuho . Basubira kumuhamagara mugihe inzibacyuho itangiye ariko itararangira . Mubyongeyeho, uburyo bwo guhamagarira ibice byinzibacyuho bizirengagizwa .
Koresha ibikubiyemo nkibintu bishobora gusenyuka. Emera amahitamo object
.
Urashobora gukora gusenyuka urugero hamwe nubwubatsi, kurugero:
var myCollapse = document.getElementById('myCollapse')
var bsCollapse = new bootstrap.Collapse(myCollapse, {
toggle: false
})
Uburyo | Ibisobanuro |
---|---|
toggle |
Kuzuza ikintu gishobora kugwa kugirango werekane cyangwa uhishe. Garuka kumuhamagara mbere yuko ikintu gishobora kugwa cyerekanwe cyangwa cyihishe (ni ukuvuga mbere yuko ibyabaye shown.bs.collapse cyangwa hidden.bs.collapse ibyabaye bibaho). |
show |
Erekana ikintu gishobora kugwa. Garuka kumuhamagara mbere yuko ibintu bisenyuka byerekanwe mubyukuri (urugero, mbere yuko shown.bs.collapse ibyabaye bibaho). |
hide |
Hisha ikintu gishobora kugwa. Garuka kumuhamagara mbere yuko ibintu bigwa byihishe mubyukuri (urugero, mbere yuko hidden.bs.collapse ibyabaye bibaho). |
dispose |
Gusenya ikintu cyo gusenyuka. (Kuraho amakuru yabitswe kubintu bya DOM) |
getInstance |
Uburyo buhamye butuma ubona urugero rwo gusenyuka rujyanye nibintu bya DOM, urashobora kubikoresha gutya:bootstrap.Collapse.getInstance(element) |
getOrCreateInstance |
Uburyo buhagaze busubiza gusenyuka bifitanye isano na DOM cyangwa gukora bundi bushya mugihe bitatangijwe. Urashobora kuyikoresha gutya:bootstrap.Collapse.getOrCreateInstance(element) |
Ibyabaye
Bootstrap yo gusenyuka ibyiciro byerekana ibintu bike byo guhuza ibikorwa.
Ubwoko bwibyabaye | Ibisobanuro |
---|---|
show.bs.collapse |
Ibirori birasa ako kanya mugihe show urugero rwitwa. |
shown.bs.collapse |
Ibi birori birukanwa mugihe ikintu cyo gusenyuka cyakozwe kigaragara kubakoresha (bizategereza ko inzibacyuho ya CSS irangira). |
hide.bs.collapse |
Iki gikorwa kirahita gihita iyo hide uburyo bwahamagawe. |
hidden.bs.collapse |
Ibirori birukanwa mugihe ikintu cyo gusenyuka cyihishe kumukoresha (uzategereza ko inzibacyuho ya CSS irangira). |
var myCollapsible = document.getElementById('myCollapsible')
myCollapsible.addEventListener('hidden.bs.collapse', function () {
// do something...
})