Romahdus
Muuta projektisi sisällön näkyvyyttä muutamilla luokilla ja JavaScript-laajennuksillamme.
Kuinka se toimii
Kutista JavaScript-laajennusta käytetään sisällön näyttämiseen ja piilottamiseen. Painikkeita tai ankkureita käytetään laukaisimina, jotka on yhdistetty tiettyihin elementteihin, joita vaihdat. Elementin tiivistäminen animoi height
sen nykyisestä arvosta arvoon 0
. Koska CSS käsittelee animaatioita, et voi käyttää padding
elementissä .collapse
. Käytä sen sijaan luokkaa itsenäisenä kääreelementtinä.
prefers-reduced-motion
mediakyselystä. Katso
esteettömyysdokumentaation osio liikkeen vähentämisestä .
Esimerkki
Napsauta alla olevia painikkeita näyttääksesi ja piilottaaksesi toisen elementin luokkamuutosten kautta:
.collapse
piilottaa sisällön.collapsing
käytetään siirtymien aikana.collapse.show
näyttää sisältöä
Yleensä suosittelemme painikkeen käyttöä data-target
määritteen kanssa. Vaikka sitä ei suositella semanttisesta näkökulmasta, voit myös käyttää linkkiä href
attribuutilla (ja role="button"
). Molemmissa tapauksissa data-toggle="collapse"
vaaditaan.
<p>
<a class="btn btn-primary" data-toggle="collapse" href="#collapseExample" role="button" aria-expanded="false" aria-controls="collapseExample">
Link with href
</a>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#collapseExample" aria-expanded="false" aria-controls="collapseExample">
Button with data-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>
Vaakasuora
Collapse plugin tukee myös vaakasuuntaista kutistamista. Lisää .width
muuntajaluokka siirtääksesi sen width
sijaan height
ja aseta width
välittömään lapsielementtiin. Voit vapaasti kirjoittaa oman mukautetun Sassin, käyttää upotettuja tyylejä tai käyttää leveysapuohjelmiamme .
min-height
vältetään liialliset uudelleenmaalaukset asiakirjoissamme, tätä ei erikseen vaadita.
Vain width
lapsielementti vaaditaan.
<p>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#collapseWidthExample" aria-expanded="false" aria-controls="collapseWidthExample">
Toggle width collapse
</button>
</p>
<div style="min-height: 120px;">
<div class="collapse width" id="collapseWidthExample">
<div class="card card-body" style="width: 320px;">
This is some placeholder content for a horizontal collapse. It's hidden by default and shown when triggered.
</div>
</div>
</div>
Useita kohteita
A <button>
tai <a>
voi näyttää ja piilottaa useita elementtejä viittaamalla niihin JQuery-valitsimella sen href
tai data-target
attribuutissa. Useita <button>
tai <a>
voivat näyttää ja piilottaa elementin, jos jokainen viittaa siihen omalla href
tai data-target
attribuutilla
<p>
<a class="btn btn-primary" data-toggle="collapse" href="#multiCollapseExample1" role="button" aria-expanded="false" aria-controls="multiCollapseExample1">Toggle first element</a>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#multiCollapseExample2" aria-expanded="false" aria-controls="multiCollapseExample2">Toggle second element</button>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-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>
Haitari esimerkki
Korttikomponentin avulla voit laajentaa oletusarvoista tiivistystoimintoa luodaksesi haitari. Haitarityylin saavuttamiseksi oikein, muista käyttää .accordion
kääreenä.
.show
luokan ansiosta.
<div class="accordion" id="accordionExample">
<div class="card">
<div class="card-header" id="headingOne">
<h2 class="mb-0">
<button class="btn btn-link btn-block text-left" type="button" data-toggle="collapse" data-target="#collapseOne" aria-expanded="true" aria-controls="collapseOne">
Collapsible Group Item #1
</button>
</h2>
</div>
<div id="collapseOne" class="collapse show" aria-labelledby="headingOne" data-parent="#accordionExample">
<div class="card-body">
Some placeholder content for the first accordion panel. This panel is shown by default, thanks to the <code>.show</code> class.
</div>
</div>
</div>
<div class="card">
<div class="card-header" id="headingTwo">
<h2 class="mb-0">
<button class="btn btn-link btn-block text-left collapsed" type="button" data-toggle="collapse" data-target="#collapseTwo" aria-expanded="false" aria-controls="collapseTwo">
Collapsible Group Item #2
</button>
</h2>
</div>
<div id="collapseTwo" class="collapse" aria-labelledby="headingTwo" data-parent="#accordionExample">
<div class="card-body">
Some placeholder content for the second accordion panel. This panel is hidden by default.
</div>
</div>
</div>
<div class="card">
<div class="card-header" id="headingThree">
<h2 class="mb-0">
<button class="btn btn-link btn-block text-left collapsed" type="button" data-toggle="collapse" data-target="#collapseThree" aria-expanded="false" aria-controls="collapseThree">
Collapsible Group Item #3
</button>
</h2>
</div>
<div id="collapseThree" class="collapse" aria-labelledby="headingThree" data-parent="#accordionExample">
<div class="card-body">
And lastly, the placeholder content for the third and final accordion panel. This panel is hidden by default.
</div>
</div>
</div>
</div>
Esteettömyys
Muista lisätä aria-expanded
ohjauselementtiin. Tämä attribuutti välittää nimenomaisesti ohjausobjektiin liitetyn kokoontaitettavan elementin nykyisen tilan näytönlukuohjelmiin ja vastaaviin aputekniikoihin. Jos kokoontaitettava elementti on oletuksena suljettu, ohjauselementin attribuutin arvon tulee olla aria-expanded="false"
. Jos olet asettanut kokoontaitettavan elementin oletusarvoisesti avoimeksi show
luokkaa käyttämällä, aseta aria-expanded="true"
sen sijaan ohjausobjekti. Plugin vaihtaa automaattisesti tämän määritteen ohjausobjektissa sen perusteella, onko tiivistettävä elementti avattu vai suljettu (JavaScriptin kautta tai koska käyttäjä laukaisi toisen ohjauselementin, joka on myös sidottu samaan tiivistettävään elementtiin). Jos ohjauselementin HTML-elementti ei ole painike (esim. an <a>
tai <div>
), määriterole="button"
tulee lisätä elementtiin.
Jos ohjauselementtisi kohdistuu yhteen tiivistettävään elementtiin – eli data-target
attribuutti osoittaa id
valitsimeen – sinun tulee lisätä aria-controls
attribuutti ohjauselementtiin, joka sisältää id
tiivistettävän elementin. Nykyaikaiset näytönlukijat ja vastaavat aputekniikat hyödyntävät tätä attribuuttia tarjotakseen käyttäjille lisäpikakuvakkeita, joilla he voivat siirtyä suoraan kokoontaitettavaan elementtiin.
Huomaa, että Bootstrapin nykyinen toteutus ei kata erilaisia näppäimistön vuorovaikutuksia, jotka on kuvattu ARIA Authoring Practices Guide -oppaassa harmonikkakuviossa – sinun on sisällytettävä ne itse mukautettuun JavaScriptiin.
Käyttö
Collapse-laajennus käyttää muutamia luokkia raskaiden nostojen käsittelemiseen:
.collapse
piilottaa sisällön.collapse.show
näyttää sisällön.collapsing
lisätään, kun siirtymä alkaa, ja poistetaan, kun se päättyy
Nämä luokat löytyvät _transitions.scss
.
Tietomääritteiden kautta
Lisää vain data-toggle="collapse"
ja a data-target
elementtiin määrittääksesi automaattisesti yhden tai useamman kokoontaitettavan elementin hallinnan. Attribuutti data-target
hyväksyy CSS-valitsimen, johon tiivistys sovelletaan. Muista lisätä luokka collapse
kokoontaitettavaan elementtiin. Jos haluat sen avautuvan oletusarvoisesti, lisää ylimääräinen luokka show
.
Jos haluat lisätä haitarimaista ryhmähallintaa kokoontaitettavalle alueelle, lisää data-attribuutti data-parent="#selector"
. Katso demo nähdäksesi tämän toiminnassa.
JavaScriptin kautta
Ota käyttöön manuaalisesti:
$('.collapse').collapse()
Vaihtoehdot
Vaihtoehdot voidaan välittää tietomääritteiden tai JavaScriptin kautta. Liitä tietomääritteissä vaihtoehdon nimi kohtaan data-
, kuten kohdassa data-parent=""
.
Nimi | Tyyppi | Oletus | Kuvaus |
---|---|---|---|
vanhempi | valitsin | jQuery-objekti | DOM-elementti | väärä | Jos ylätaso on annettu, kaikki määritetyn ylätason alapuolella olevat tiivistettävät elementit suljetaan, kun tämä tiivistettävä kohde näytetään. (samanlainen kuin perinteinen haitarikäyttäytyminen - tämä riippuu card luokasta). Attribuutti on asetettava kohdealueelle. |
vaihtaa | boolean | totta | Vaihtaa kokoontaitettavan elementin kutsun yhteydessä |
menetelmät
Asynkroniset menetelmät ja siirtymät
Kaikki API - menetelmät ovat asynkronisia ja aloittavat siirtymän . He palaavat soittajan luo heti siirtymisen alkaessa, mutta ennen sen päättymistä . Lisäksi siirtyvän komponentin menetelmäkutsu jätetään huomioimatta .
.collapse(options)
Aktivoi sisältösi kokoontaitettavana elementtinä. Hyväksyy valinnaiset vaihtoehdot object
.
$('#myCollapsible').collapse({
toggle: false
})
.collapse('toggle')
Vaihtaa kokoontaitettavan elementin näytettäväksi tai piilotetuksi. Palaa soittajalle ennen kuin kokoontaitettava elementti on todella näkyvissä tai piilotettu (ts. ennen shown.bs.collapse
tai hidden.bs.collapse
tapahtumaa).
.collapse('show')
Näyttää kokoontaitettavan elementin. Palaa soittajalle ennen kuin kokoontaitettava elementti on todella näytetty (eli ennen shown.bs.collapse
tapahtumaa).
.collapse('hide')
Piilottaa kokoontaitettavan elementin. Palaa soittajalle ennen kuin kokoontaitettava elementti on todella piilotettu (eli ennen hidden.bs.collapse
tapahtuman tapahtumista).
.collapse('dispose')
Tuhoaa elementin romahduksen.
Tapahtumat
Bootstrapin tiivistysluokka paljastaa muutamia tapahtumia, jotka liittyvät tiivistystoimintoon.
Tapahtumatyyppi | Kuvaus |
---|---|
show.bs.collapse | Tämä tapahtuma käynnistyy välittömästi, kun show instanssimenetelmää kutsutaan. |
näytetään.bs.kutistuminen | Tämä tapahtuma käynnistyy, kun tiivistyselementti on tehty näkyväksi käyttäjälle (odottaa CSS-siirtymien valmistumista). |
hide.bs.collapse | Tämä tapahtuma käynnistyy välittömästi, kun hide menetelmä on kutsuttu. |
piilotettu.bs.collapse | Tämä tapahtuma käynnistyy, kun tiivistyselementti on piilotettu käyttäjältä (odottaa CSS-siirtymien valmistumista). |
$('#myCollapsible').on('hidden.bs.collapse', function () {
// do something...
})