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 wandika 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 bihujwe no kugenzura 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 uyikoresha yateje ikindi kintu cyo kugenzura nacyo gifatanye nikintu kimwe gishobora 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 kugenzura ibintu, bikubiyemo id
ibintu byangirika. Abasomyi ba kijyambere bigezweho hamwe na tekinoroji ifasha ikoresha iyi miterere kugirango itange abakoresha andi magufi kugirango bayobore neza kubintu byangirika ubwabyo.
Menya ko Bootstrap ishyirwa mubikorwa ntabwo ikubiyemo imikoranire itandukanye ya clavier yasobanuwe muburyo bwa ARIA Authoring Practices Guide bordion - uzakenera gushyiramo wowe ubwawe hamwe na JavaScript yihariye.
Sass
Ibihinduka
$transition-collapse: height .35s ease;
$transition-collapse-width: width .35s ease;
Amasomo
Gusenya 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
cyemera CSS uhitamo kugirango akoreshe gusenyuka kuri. Wemeze kongeramo urwego collapse
kubintu bishobora kugwa. Niba wifuza ko byanze bikunze bifungura, ongeraho urwego rwinyongera show
.
Kugirango wongere imirwi imeze nkitsinda 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:
const collapseElementList = document.querySelectorAll('.collapse')
const collapseList = [...collapseElementList].map(collapseEl => new bootstrap.Collapse(collapseEl))
Amahitamo
Nkuko amahitamo ashobora kunyuzwa kumurongo wamakuru cyangwa JavaScript, urashobora kongeramo izina ryamahitamo data-bs-
, nkuko biri data-bs-animation="{value}"
. Witondere guhindura ubwoko bwurubanza rwamahitamo kuva " ingamiya " kuri " kebab-urubanza " mugihe utambutsa amahitamo ukoresheje ibiranga amakuru. Kurugero, koresha data-bs-custom-class="beautifier"
aho data-bs-customClass="beautifier"
.
Nko muri Bootstrap 5.2.0, ibice byose bishyigikira igeragezwa ryibitse ryamakuru data-bs-config
rishobora kubamo ibice byoroshye nkibikoresho bya JSON. Mugihe ikintu gifite data-bs-config='{"delay":0, "title":123}'
nibiranga data-bs-title="456"
, agaciro kanyuma title
kazaba 456
kandi amakuru yihariye aranga agaciro katanzwe kuri data-bs-config
. Mubyongeyeho, amakuru ariho aranga arashobora kubika JSON indangagaciro nka data-bs-delay='{"show":0,"hide":150}'
.
Izina | Andika | Mburabuzi | Ibisobanuro |
---|---|---|---|
parent |
uwatoranije, DOM element | null |
Niba umubyeyi yatanzwe, noneho ibintu byose bishobora gusenyuka munsi yumubyeyi wabigenewe bizafungwa mugihe iki kintu gishobora kugwa. (bisa nimyitwarire 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 kugwa. Emera amahitamo object
.
Urashobora gukora gusenyuka urugero hamwe nubwubatsi, kurugero:
const bsCollapse = new bootstrap.Collapse('#myCollapse', {
toggle: false
})
Uburyo | Ibisobanuro |
---|---|
dispose |
Gusenya ikintu cyo gusenyuka. (Kuraho amakuru yabitswe kubintu bya DOM) |
getInstance |
Uburyo buhagaze 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) . |
hide |
Hisha ikintu gishobora kugwa. Garuka kumuhamagara mbere yuko ibintu bigwa byihishe mubyukuri (urugero, mbere yuko hidden.bs.collapse ibyabaye bibaho). |
show |
Erekana ikintu gishobora kugwa. Garuka kumuhamagara mbere yuko ibintu bigwa byerekanwe mubyukuri (urugero, mbere yuko shown.bs.collapse ibyabaye bibaho). |
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). |
Ibyabaye
Bootstrap yo gusenyuka ibyiciro byerekana ibintu bike byo guhuza ibikorwa.
Ubwoko bwibyabaye | Ibisobanuro |
---|---|
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). |
show.bs.collapse |
Ibirori birasa ako kanya mugihe show urugero rwitwa. |
shown.bs.collapse |
Ibirori birukanwa mugihe ikintu cyo gusenyuka cyakozwe kigaragara kubakoresha (bizategereza ko CSS ihinduka). |
const myCollapsible = document.getElementById('myCollapsible')
myCollapsible.addEventListener('hidden.bs.collapse', event => {
// do something...
})