Jya ku bintu nyamukuru Jya kuri docs
in English

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 heightkuva agaciro kayo kugeza 0. Urebye uburyo CSS ikora animasiyo, ntushobora gukoresha paddingkubintu .collapse. Ahubwo, koresha urwego nkibintu byigenga bipfunyika.

Ingaruka ya animasiyo yibi bice biterwa prefers-reduced-motionnibibazo byitangazamakuru. Reba igice cyagabanijwe cyicyiciro cyibisobanuro byacu .

Urugero

Kanda buto hepfo kugirango werekane kandi uhishe ikindi kintu ukoresheje impinduka zamasomo:

  • .collapseahisha ibirimo
  • .collapsingni Byakoreshejwe Mugihe Cyinzibacyuho
  • .collapse.showyerekana ibirimo

Mubisanzwe, turasaba gukoresha buto ifite data-bs-targetikiranga. Mugihe udasabwe kuva mubisobanuro, urashobora kandi gukoresha umurongo hamwe na hrefkiranga (na a role="button"). Muri ibyo bihe byombi, data-bs-toggle="collapse"urasabwa.

Some placeholder content for the collapse component. This panel is hidden by default but revealed when the user activates the relevant trigger.
<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>

Intego nyinshi

A <button>cyangwa <a>irashobora kwerekana no guhisha ibintu byinshi mubohereza hamwe nuwatoranije muri hrefcyangwa data-bs-targetikiranga. Igwije <button>cyangwa irashobora kwerekana no <a>guhisha ikintu niba buriwese abigaragaza hamwe nibirangahrefdata-bs-target

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.
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.
<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-expandedkubintu 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-targetikiranga cyerekana iduwatoranije - ugomba kongeramo aria-controlsikiranga kubintu bigenzura, bikubiyemo idibintu 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;

Amasomo

Gusenyuka ibyiciro byinzibacyuho murashobora kubisanga scss/_transitions.scssnkuko bisangiwe mubice byinshi (gusenyuka na bordion).

.collapse {
  &:not(.show) {
    display: none;
  }
}

.collapsing {
  height: 0;
  overflow: hidden;
  @include transition($transition-collapse);
}

Ikoreshwa

Gusenyuka plugin ikoresha ibyiciro bike kugirango ikemure ibintu biremereye:

  • .collapseahisha ibirimo
  • .collapse.showyerekana ibirimo
  • .collapsingyongeweho 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-targetkubintu kugirango uhite ugenera kugenzura ikintu kimwe cyangwa byinshi bishobora gusenyuka. Ikiranga data-bs-targetcyakira CSS uhitamo kugirango akoreshe gusenyuka kuri. Wemeze kongeramo urwego collapsekubintu 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 kuri demo kugirango ubone ibi mubikorwa.

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 cardnurwego). 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 .

Reba inyandiko zacu za JavaScript kubindi bisobanuro .

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.collapsecyangwa hidden.bs.collapseibyabaye bibaho).
show Erekana ikintu gishobora kugwa. Garuka kumuhamagara mbere yuko ibintu bisenyuka byerekanwe mubyukuri (urugero, mbere yuko shown.bs.collapseibyabaye bibaho).
hide Hisha ikintu gishobora kugwa. Garuka kumuhamagara mbere yuko ibintu bigwa byihishe mubyukuri (urugero, mbere yuko hidden.bs.collapseibyabaye 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 showurugero 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 hideuburyo 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...
})