Tīpoka ki te ihirangi matua Tīpoka ki te whakaterenga tuhinga
in English

Tiango

Takahurihia te whakakitenga o te ihirangi puta noa i to kaupapa me etahi karaehe me a maatau taputapu JavaScript.

Pehea te mahi

Ka whakamahia te mono JavaScript tiango hei whakaatu me te huna i nga ihirangi. Ka whakamahia nga patene, punga ranei hei keu ka mapi ki nga huānga motuhake ka takahurihia e koe. Ma te tiango i tetahi huānga ka whakakorikori i te heightmai i tona uara o naianei ki 0. Me pehea te whakahaere a CSS i nga pakiwaituhi, kaore e taea e koe te whakamahi paddingi runga i tetahi .collapsehuānga. Engari, whakamahia te akomanga hei huānga takai motuhake.

Ko te awe hākoritanga o tēnei wāhanga e whakawhirinaki ana ki te prefers-reduced-motionuiui pāpāho. Tirohia te waahanga motini whakaheke o a maatau tuhinga whakaurunga .

Tauira

Patohia nga paatene i raro nei hei whakaatu me te huna i tetahi atu huānga ma nga huringa akomanga:

  • .collapsehuna ihirangi
  • .collapsingka whakamahia i nga wa whakawhiti
  • .collapse.showwhakaatu ihirangi

Ko te tikanga, ka tūtohu matou ki te whakamahi i te paatene me te data-bs-targethuanga. Ahakoa kaore i te tūtohutia mai i te tirohanga o te reo, ka taea hoki e koe te whakamahi i te hono me te hrefhuanga (me te role="button"). I roto i nga take e rua, data-bs-toggle="collapse"e hiahiatia ana.

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>

Nga whaainga maha

Ka taea e A <button>ranei <a>te whakaatu me te huna i nga huānga maha ma te tohutoro me tetahi kaikowhiri i tona huanga hrefranei . data-bs-targetHe maha , ka taea <button>ranei <a>te whakaatu me te huna i tetahi huānga mena ka tohua e ia me o hrefraatau data-bs-targethuanga

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>

Te urunga

Me tino taapiri atu aria-expandedki te huānga mana. Ko tenei huanga e whakaatu marama ana i te ahuatanga o naianei o te huānga tiango e herea ana ki te mana ki nga kaipanui mata me nga hangarau awhina rite. Mena kua katia te huānga tiango ma te taunoa, me whai uara o te huanga o te huānga mana aria-expanded="false". Mena kua tautuhia e koe te huānga tiango kia tuwhera ma te taunoa ma te whakamahi i te showkaraehe, tohua aria-expanded="true"ki te mana. Ka takahuri aunoa te mono i tenei huanga i runga i te mana i runga i te mea kua whakatuwherahia, kua kati ranei te huānga tiango (ma te JavaScript, na te mea i whakaoho te kaiwhakamahi i tetahi atu huānga mana e herea ana ki taua huānga tiango). Mena ko te huānga HTML o te mana whakahaere ehara i te paatene (hei tauira, he <a>ranei <div>), te huangarole="button"me taapiri atu ki te huānga.

Mēnā e aro ana tō huānga mana ki tētahi huānga tiango kotahi – arā data-bs-target, e tohu ana te huanga ki tētahi idkaikōwhiri – me tāpiri koe i te aria-controlshuanga ki te huānga mana, kei roto te ido te huānga tiango. Ka whakamahia e nga kaipanui mata hou me nga hangarau awhina rite tenei huanga ki te whakarato ki nga kaiwhakamahi etahi atu pokatata ki te whakatere tika ki te huānga tiango ake.

Kia mahara ko te whakatinanatanga o naianei a Bootstrap kaore i te kapi i nga momo taunekeneke papapātuhi kua tohua i roto i te tauira akoriona Wai-ARIA Authoring Practices 1.1 - me whakauru e koe enei ki te JavaScript ritenga.

Sass

Taurangi

$transition-collapse:         height .35s ease;

Karaehe

Ka kitea nga karaehe whakawhiti tiango i te scss/_transitions.scssmea ka tohatohahia enei ki nga waahanga maha (te tiango me te accordion).

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

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

Whakamahinga

Ka whakamahia e te mono tiango etahi karaehe hei hapai i te hiki taumaha:

  • .collapseka huna i te ihirangi
  • .collapse.showwhakaatu te ihirangi
  • .collapsingka taapirihia ina timata te whakawhiti, ka tangohia ina mutu

Ka kitea enei akomanga i roto i _transitions.scss.

Ma nga huanga raraunga

Taapiri noa data-bs-toggle="collapse"me te data-bs-targeta ki te huānga hei tautapa aunoa i te mana o tetahi, neke atu ranei nga huānga tiango. Ka data-bs-targetwhakaaetia e te huanga he kaikowhiri CSS hei hoatu i te tiango ki. Me tino taapiri te karaehe collapseki te huānga tiango. Mena kei te pirangi koe kia tuwhera taunoa, taapirihia te akomanga taapiri show.

Hei taapiri i te whakahaere roopu rite-akordion ki tetahi waahi tiango, taapirihia te huanga raraunga data-bs-parent="#selector". Tirohia te demo kia kite i tenei mahi.

Ma te JavaScript

Whakahohe ā-ringa ki:

var collapseElementList = [].slice.call(document.querySelectorAll('.collapse'))
var collapseList = collapseElementList.map(function (collapseEl) {
  return new bootstrap.Collapse(collapseEl)
})

Kōwhiringa

Ko nga whiringa ka taea te tuku ma nga huanga raraunga, JavaScript ranei. Mo nga huanga raraunga, apitihia te ingoa whiringa ki data-bs-, penei i te data-bs-parent="".

Ingoa Momo Taunoa Whakaahuatanga
parent kaiwhiriwhiri | ahanoa jQuery | Huānga DOM false Mena ka tukuna he matua, ka kati nga huānga tiango katoa i raro i te matua kua tohua ina whakaatuhia tenei mea tiango. (he rite ki te whanonga accordion tuku iho - ka whakawhirinaki tenei ki te cardkaraehe). Me whakanoho te huanga ki runga i te waahi ka taea te tiango.
toggle boolean true Ka takahuri i te huānga tiango i runga i te inoi

Nga tikanga

Nga tikanga tukutahi me nga whakawhitinga

Ko nga tikanga API katoa he tukutahi ka timata te whakawhiti . Ka hoki mai ano ki te kaikaranga ina timata te whakawhiti engari i mua i te mutunga . I tua atu, ka warewarehia te karanga tikanga mo tetahi waahanga whakawhiti .

Tirohia ta maatau tuhinga JavaScript mo etahi atu korero .

Ka whakahohe i to ihirangi hei huānga tiango. Ka whakaae ki nga whiringa whiriwhiri object.

Ka taea e koe te hanga tauira tiango me te kaihanga, hei tauira:

var myCollapse = document.getElementById('myCollapse')
var bsCollapse = new bootstrap.Collapse(myCollapse, {
  toggle: false
})
Tikanga Whakaahuatanga
toggle Ka takahuri i tetahi huānga tiango hei whakaatu, huna ranei. Ka hoki ki te kaiwaea i mua i te whakaaturanga, huna ranei o te huānga tiango (arā, i mua i te puta o shown.bs.collapsete hidden.bs.collapsetakahanga).
show He whakaatu huānga tiango. Ka hoki ki te kaiwaea i mua i te whakaaturanga o te huānga tiango (hei tauira, i mua i te shown.bs.collapseputa o te takahanga).
hide Hunaia he huānga tiango. Ka hoki ki te kaiwaea i mua i te hunanga o te huānga tiango (hei tauira, i mua i te hidden.bs.collapseputa o te takahanga).
dispose Ka whakangaro i te tiango o te huānga. (Tangohia ai nga raraunga rongoa i te huānga DOM)
getInstance Tikanga pateko e taea ai e koe te tiki i te tauira tiango e hono ana ki tetahi huānga DOM, ka taea e koe te whakamahi penei:bootstrap.Collapse.getInstance(element)
getOrCreateInstance Aratuka pateko e whakahoki mai ana i te takahanga tiango e hono ana ki tetahi huānga DOM, ka hanga ranei i tetahi mea hou mena kaore i arawhitia. Ka taea e koe te whakamahi penei:bootstrap.Collapse.getOrCreateInstance(element)

Nga huihuinga

Ko te karaehe tiango a Bootstrap e whakaatu ana i etahi huihuinga mo te hono ki te mahi tiango.

Momo takahanga Whakaahuatanga
show.bs.collapse Ka pupuhi tenei takahanga ina ka showkarangahia te aratuka tauira.
shown.bs.collapse Ka pupuhihia tenei takahanga ina kitea he huānga tiango ki te kaiwhakamahi (ka tatari kia oti nga whakawhitinga CSS).
hide.bs.collapse Ka pupuhihia tenei kaupapa i te wa hidei kiia ai te tikanga.
hidden.bs.collapse Ka pupuhihia tenei takahanga ina hunahia he huānga tiango mai i te kaiwhakamahi (ka tatari kia oti nga whakawhitinga CSS).
var myCollapsible = document.getElementById('myCollapsible')
myCollapsible.addEventListener('hidden.bs.collapse', function () {
  // do something...
})