Jya ku bintu nyamukuru Jya kuri docs
Check
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.
html
<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-horizontalicyiciro cyo guhindura kugirango uhindure widthaho kugirango heightushireho ikintu widthcyumwana uhita. Wumve neza ko wandika Sass yawe yihariye, koresha inline, cyangwa ukoreshe ubugari bwacu .

Nyamuneka menya ko mugihe urugero rukurikira rufite gahunda min-heightyo kwirinda gusiga irangi muri docs, ibi ntabwo bisabwa neza. Gusa widthibyingenzi kumwana birakenewe.

This is some placeholder content for a horizontal collapse. It's hidden by default and shown when triggered.
html
<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 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.
html
<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 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-targetikiranga cyerekana iduwatoranije - ugomba kongeramo aria-controlsikiranga kugenzura ibintu, bikubiyemo idibintu 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.scssnkuko 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:

  • .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-targetcyemera CSS uhitamo kugirango akoreshe gusenyuka kuri. Wemeze kongeramo urwego collapsekubintu 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-configrishobora kubamo ibice byoroshye nkibikoresho bya JSON. Mugihe ikintu gifite data-bs-config='{"delay":0, "title":123}'nibiranga data-bs-title="456", agaciro kanyuma titlekazaba 456kandi 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 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 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.collapseibyabaye bibaho).
show Erekana ikintu gishobora kugwa. Garuka kumuhamagara mbere yuko ibintu bigwa byerekanwe mubyukuri (urugero, mbere yuko shown.bs.collapseibyabaye 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.collapsecyangwa hidden.bs.collapseibyabaye bibaho).

Ibyabaye

Bootstrap yo gusenyuka ibyiciro byerekana ibintu bike byo guhuza ibikorwa.

Ubwoko bwibyabaye Ibisobanuro
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).
show.bs.collapse Ibirori birasa ako kanya mugihe showurugero 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...
})