Koaleha
Fetolela ponahalo ea litaba mosebetsing oa hau ka lihlopha tse 'maloa le li-plugins tsa rona tsa JavaScript.
Kamoo e sebetsang kateng
Ho putlama JavaScript plugin e sebelisetsoa ho bontša le ho pata litaba. Likonopo kapa li-ankora li sebelisoa e le lintho tse susumetsang tse etselitsoeng likarolo tse itseng tseo u li fetolang. Ho putlama element ho tla phelisa ho height
tloha ho boleng ba hona joale ho isa ho 0
. Ho latela hore na CSS e sebetsana joang le lipopae, u ke ke ua sebelisa ntho padding
e .collapse
itseng. Ho e-na le hoo, sebelisa sehlopha e le ntho e ikemetseng ea ho phuthela.
prefers-reduced-motion
potso ea media. Sheba karolo e
fokolitsoeng ea motsamao oa litokomane tsa phihlello ea rona .
Mohlala
Tobetsa likonopo tse ka tlase ho bontša le ho pata ntho e 'ngoe ka liphetoho tsa sehlopha:
.collapse
e pata litaba.collapsing
e sebelisoa nakong ea liphetoho.collapse.show
e bontsha dikahare
Ka kakaretso, re khothaletsa ho sebelisa konopo e nang le data-bs-target
tšobotsi. Leha e sa khothaletsoe ho tsoa ponong ea semantic, o ka sebelisa sehokelo se nang le href
tšobotsi (le a role="button"
). Maemong ana ka bobeli, ho data-bs-toggle="collapse"
hlokahala.
<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>
E tshekaletseng
Ho putlama ha plugin ho boetse ho ts'ehetsa ho putlama ho otlolohileng. Eketsa sehlopha sa .collapse-horizontal
modifier ho fetola ho e width
-na height
le ho beha ntho width
e haufi ea ngoana. Ikutloe u lokolohile ho ngola Sass ea hau ea tloaelo, sebelisa setaele sa inline, kapa sebelisa lisebelisoa tsa rona tsa bophara .
min-height
ho qoba ho penta ho feteletseng ho litokomane tsa rona, sena ha se hlokehe ka ho hlaka.
Ho hlokahala feela karolo width
ea ngoana.
<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>
Lipheo tse ngata
A <button>
kapa <a>
e ka bonts'a le ho pata likarolo tse ngata ka ho li supa ka khetho ho eona href
kapa data-bs-target
tšobotsi. E mengata <button>
kapa <a>
e ka bonts'a le ho pata ntho haeba e mong le e mong a e supa ka href
tšobotsi data-bs-target
ea bona
<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>
Ho fihlella
Etsa bonnete ba hore o eketsa aria-expanded
karolo ea taolo. Tšobotsi ena e hlahisa ka ho hlaka boemo ba hona joale ba ntho e ka putlamang e hokahaneng le taolo ho libali tsa skrini le lisebelisoa tse ling tse thusang. Haeba ntho e putlamang e koetsoe ka ho sa feleng, tšobotsi e karolong ea taolo e lokela ho ba le boleng ba aria-expanded="false"
. Haeba u setehile hore ntho e ka phuthoang e buloe ka mokhoa oa kamehla u sebelisa show
sehlopha, beha aria-expanded="true"
taolong. Plugin e tla fetola tšobotsi ena ka bo eona taolong e ipapisitse le hore na ntho e putlang e butsoe kapa che e koetsoe (ka JavaScript, kapa hobane mosebelisi a hlahisitse karolo e 'ngoe ea taolo le eona e hokeletsoeng nthong e tšoanang e putlang). Haeba karolo ea taolo ea HTML e se konopo (mohlala, <a>
kapa <div>
), tšobotsirole="button"
e lokela ho eketsoa ho element.
Haeba karolo ea hau ea taolo e shebile ntho e le 'ngoe e putlang - ke hore, data-bs-target
tšobotsi e supa ho id
khetho - o lokela ho eketsa aria-controls
tšobotsi ho karolo ea taolo, e nang le id
ntho e putlamang. Babali ba skrine ba sejoale-joale le mahlale a thusang a tšoanang a sebelisa tšobotsi ena ho fa basebelisi likhutšoane tse ling tsa ho ea ka kotloloho ho ntho e putlang ka boyona.
Hlokomela hore ts'ebetsong ea hajoale ea Bootstrap ha e akaretse litšebelisano tse fapaneng tsa keyboard tse hlalositsoeng ho ARIA Authoring Practices Guide paterone ea accordion - o tla hloka ho li kenyelletsa le JavaScript ea tloaelo.
Sass
Lintho tse fapaneng
$transition-collapse: height .35s ease;
$transition-collapse-width: width .35s ease;
Lihlopha
Litlelase tsa ho putlama li ka fumanoa scss/_transitions.scss
kaha tsena li arolelanoa ka likarolo tse ngata (ho putlama le accordion).
.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);
}
}
Tšebeliso
Plugin ea ho putlama e sebelisa lihlopha tse 'maloa ho sebetsana le ho phahamisa boima:
.collapse
e pata litaba.collapse.show
e bontsha dikahare.collapsing
e eketsoa ha phetoho e qala, mme e tlosoe ha e fela
Lihlopha tsena li ka fumanoa ho _transitions.scss
.
Ka litšobotsi tsa data
Kenya feela data-bs-toggle="collapse"
le a data-bs-target
ho element ho fana ka taolo ea ntho e le 'ngoe kapa tse ngata tse putlang. data-bs-target
Tšobotsi e amohela khetho ea CSS eo o ka sebelisang ho putlama ho eona . Etsa bonnete ba hore o kenyelletsa sehlopha collapse
ho ntho e putlang. Haeba u rata hore e bulehe ka mokhoa o tloaelehileng, eketsa sehlopha sa tlatsetso show
.
Ho kenya taolo ea sehlopha se kang accordion sebakeng se putlahang, eketsa tšobotsi ea data data-bs-parent="#selector"
. Sheba leqephe la accordion bakeng sa lintlha tse ling.
Ka JavaScript
Lumella ka letsoho ka:
const collapseElementList = document.querySelectorAll('.collapse')
const collapseList = [...collapseElementList].map(collapseEl => new bootstrap.Collapse(collapseEl))
Dikgetho
Kaha likhetho li ka fetisoa ka lintlha tsa data kapa JavaScript, u ka kenyelletsa lebitso la khetho ho data-bs-
, joalo ka data-bs-animation="{value}"
. Etsa bonnete ba hore o fetola mofuta oa nyeoe ea lebitso la khetho ho tloha " camelCase "ho " kebab-case " ha o fetisa likhetho ka litšobotsi tsa data. Ka mohlala, sebelisa data-bs-custom-class="beautifier"
ho e-na le data-bs-customClass="beautifier"
.
Ho tloha ka Bootstrap 5.2.0, likarolo tsohle li ts'ehetsa tlhahlobo ea data e bolokiloeng data-bs-config
e ka bolokang tlhophiso e bonolo ea karolo joalo ka khoele ea JSON. Ha element e na data-bs-config='{"delay":0, "title":123}'
le data-bs-title="456"
litšoaneleho, boleng ba ho qetela title
bo tla ba 456
'me lintlha tse arohaneng tsa data li tla feta boleng bo fanoeng ho data-bs-config
. Ntle le moo, litšoaneleho tse teng tsa data li khona ho boloka boleng ba JSON joalo ka data-bs-delay='{"show":0,"hide":150}'
.
Lebitso | Mofuta | Ea kamehla | Tlhaloso |
---|---|---|---|
parent |
mokhethi, karolo ea DOM | null |
Haeba ho fanoe ka motsoali, likarolo tsohle tse ka bokelloang tlas'a motsoali ea boletsoeng li tla koaloa ha ntho ena e bonohang e bontšoa. (e ts'oanang le boitšoaro ba accordion ea setso - sena se itšetlehile ka card sehlopha). Sebopeho se tlameha ho beoa sebakeng se putlahang. |
toggle |
boolean | true |
E fetola ntho e ka putlamang kopong. |
Mekhoa
Mekhoa ea Asynchronous le liphetoho
Mekhoa eohle ea API ha e- synchronous 'me e qala phetoho . Ba khutlela ho motho ea letselitseng hang ha phetoho e qala empa pele e fela . Ho feta moo, mohala oa mokhoa ho karolo ea phetoho o tla hlokomolohuoa .
Sheba litokomane tsa rona tsa JavaScript bakeng sa lintlha tse ling .
E kenya tšebetsong litaba tsa hau joalo ka ntho e ka putlamang. E amohela khetho ea boikhethelo object
.
O ka etsa mohlala oa ho putlama le moetsi, mohlala:
const bsCollapse = new bootstrap.Collapse('#myCollapse', {
toggle: false
})
Mokhoa | Tlhaloso |
---|---|
dispose |
E senya ho putlama ha element. (E tlosa lintlha tse bolokiloeng karolong ea DOM) |
getInstance |
Mokhoa o tsitsitseng o o lumellang ho fumana mohlala oa ho putlama o amanang le karolo ea DOM, o ka e sebelisa tjena: bootstrap.Collapse.getInstance(element) . |
getOrCreateInstance |
Mokhoa o tsitsitseng o khutlisetsang ketsahalo ea ho putlama e amanang le karolo ea DOM kapa ho theha e ncha haeba e sa qalisoa. U ka e sebelisa ka tsela ena bootstrap.Collapse.getOrCreateInstance(element) :. |
hide |
E pata ntho e putlang. E khutlela ho ea letselitseng pele ntho e putlang e patiloe (mohlala, pele hidden.bs.collapse ketsahalo e etsahala). |
show |
E bonts'a ntho e putlahang. E khutlela ho ea letselitseng pele ntho e putlang e bonts'oa (mohlala, pele shown.bs.collapse ketsahalo e etsahala). |
toggle |
E fetolela ntho e putlahang hore e bontšoe kapa e patiloe. E khutlela ho moletsi pele ntho e putlahang e bonts'oa kapa e patiloe (ke hore pele ketsahalo shown.bs.collapse kapa hidden.bs.collapse ketsahalo e etsahala). |
Liketsahalo
Sehlopha sa ho putlama sa Bootstrap se pepesa liketsahalo tse 'maloa bakeng sa ho hokahana le ts'ebetso ea ho putlama.
Mofuta oa ketsahalo | Tlhaloso |
---|---|
hide.bs.collapse |
Ketsahalo ena e lelekoa hang-hang ha hide mokhoa o bitsoa. |
hidden.bs.collapse |
Ketsahalo ena e ts'oaroa ha ntho e putlamang e patetsoe mosebelisi (e tla emela hore liphetoho tsa CSS li phethehe). |
show.bs.collapse |
Ketsahalo ena e tuka hang hang ha show mokhoa oa mohlala o bitsoa. |
shown.bs.collapse |
Ketsahalo ena e ts'oaroa ha ntho e putlama e bonahalitsoe ho mosebelisi (e tla emela hore liphetoho tsa CSS li phethehe). |
const myCollapsible = document.getElementById('myCollapsible')
myCollapsible.addEventListener('hidden.bs.collapse', event => {
// do something...
})