कडसरावचें
कांय वर्ग आनी आमच्या जावास्क्रिप्ट प्लगइनांनी तुमच्या प्रकल्पांतल्यान सामुग्रीची दृश्यताय टॉगल करात.
कशें काम करता
सामुग्री दाखोवपाक आनी लिपोवपाक संकुचीत जावास्क्रिप्ट प्लगइन वापरतात. बटणां वा एंकर ट्रिगर म्हणून वापरतात जे तुमी टॉगल करतात त्या विशिश्ट घटकांक मॅप केल्ले आसतात. घटक संकुचीत केल्यार height
ताच्या सद्याच्या मोला वयल्यान 0
. padding
CSS एनिमेशन कशें हाताळटा तें पळयल्यार, तुमी घटकाचेर वापरूंक शकना .collapse
. ताचे बदला, वर्ग स्वतंत्र आवरण घटक म्हणून वापरात.
prefers-reduced-motion
माध्यम क्वेरीचेर आदारून आसता. आमच्या सुलभताय दस्तावेजीकरणाचो उणो केल्ली गती विभाग पळयात
.
उदारण
वर्ग बदला वरवीं दुसरो घटक दाखोवपाक आनी लिपोवपाक सकयल दिल्ल्या बटणां क्लिक करात:
.collapse
सामुग्री लिपयता.collapsing
संक्रमणाच्या वेळार लागू करतात.collapse.show
आशय दाखयता
data-bs-target
सादारणपणान, आमी गुणधर्म आशिल्लें बटण वापरपाची शिफारस करतात . अर्थीक नदरेन शिफारस केल्ली नासली तरी, तुमी href
गुणधर्म (आनी a role="button"
) आशिल्ली दुवोय वापरूं येता. दोनूय प्रकरणांत, द data-bs-toggle="collapse"
हें गरजेचें आसा.
<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>
आडवें
कोसळप प्लगइन आडव्या कोसळपाकय तेंको दिता. बदला .collapse-horizontal
the संक्रमण करपाक संशोधक वर्ग जोडात आनी तात्काळ बाल घटकाचेर a सेट करात. तुमचो स्वताचो सानुकूल Sass बरोवपाक, इनलायन शैली वापरपाक, वा आमचीं रुंदाय उपयुक्तताय वापरपाक मेकळीक दिवची .width
height
width
min-height
आमच्या डॉक्सांत चड रिपेंट टाळपाक संच आसलो तरी, हाची स्पश्टपणान गरज ना.
फकत width
on the child घटक जाय.
<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>
एका परस चड लक्ष्यां
A <button>
वा ताच्या वा गुणधर्मांतल्या <a>
निवडकरान संदर्भ दिवन जायते घटक दाखोवंक आनी लिपोवंक शकता . एका परस चड वा एक घटक दाखोवंक आनी लिपोवंक शकतात जर ते दरेकले ताचो संदर्भ तांच्या वा गुणधर्मान दितातhref
data-bs-target
<button>
<a>
href
data-bs-target
<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>
सुलभताय
aria-expanded
नियंत्रण घटकांत जोडपाची खात्री करात . हें गुणधर्म नियंत्रणाक बांदिल्ल्या संकुचीत घटकाची सद्याची स्थिती स्क्रीन रीडर आनी तत्सम सहाय्यक तंत्रज्ञानाक स्पश्टपणान सांगता. संकुचीत करपाक येवपी घटक पूर्वनिर्धारीतपणान बंद आसल्यार, नियंत्रण घटकाचेर आशिल्ल्या गुणधर्माचें मोल आसपाक जाय aria-expanded="false"
. show
जर तुमी वर्ग वापरून संकुचीत करपाक येवपी घटक पूर्वनिर्धारीतपणान उक्तो करपाक सेट केला जाल्यार, aria-expanded="true"
ताचे बदला नियंत्रणाचेर सेट करात. प्लगइन आपसूकच हें गुणधर्म नियंत्रणाचेर टॉगल करतलें तें संकुचीत करपाक येवपी घटक उगडला वा बंद केला काय ना हाचेर आदारीत (जावास्क्रिप्ट वरवीं, वा वापरप्यान त्याच संकुचीत करपाक येवपी घटकाकय बांदिल्लो दुसरो नियंत्रण घटक ट्रिगर केल्ल्यान). नियंत्रण घटकाचो HTML घटक बटण न्हय जाल्यार (देखीक, एक <a>
वा <div>
), गुणधर्मrole="button"
घटकाक जोडपाक जाय.
तुमचो नियंत्रण घटक एकाच संकुचीत घटकाक लक्ष्य करता जाल्यार – म्हळ्यार गुणधर्म निवडक data-bs-target
कडेन निर्देशीत करता – तुमी नियंत्रण घटकाक गुणधर्म जोडपाक जाय, जातूंत संकुचीत करपाक येवपी घटकाचो आसता. आधुनीक स्क्रीन रीडर आनी तत्सम सहाय्यक तंत्रज्ञान वापरप्यांक थेट संकुचीत करपाक येवपी घटकाचेरच वचपाक अतिरिक्त शॉर्टकट दिवपाक ह्या गुणधर्माचो वापर करतात.id
aria-controls
id
लक्षांत दवरात की Bootstrap ची सद्याची कार्यान्वयन ARIA लेखन पद्दती मार्गदर्शक अकॉर्डियन नमुन्यांत वर्णीत केल्ल्या वेगवेगळ्या पर्यायी कीबोर्ड परस्पर संवादांक आस्पावना - तुमकां सानुकूल JavaScript कडेन स्वता हीं समाविष्ट करचीं पडटलीं.
सास
चड-उणें
$transition-collapse: height .35s ease;
$transition-collapse-width: width .35s ease;
वर्ग घेतात
संकुचीत संक्रमण वर्ग हातूंत मेळूं येतात scss/_transitions.scss
कारण हे एका परस चड घटकांत (कोसळप आनी अकॉर्डियन) वांटून घेतात.
.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);
}
}
वापर
कोसळप प्लगइन जड उखलप हाताळपाक कांय वर्गांचो वापर करता:
.collapse
सामुग्री लिपयता.collapse.show
आशय दाखयता.collapsing
संक्रमण सुरू जातकच जोडटात, आनी सोंपतकच काडून उडयतात
हे वर्ग _transitions.scss
.
डेटा गुणधर्मां वरवीं
फकत एका वा चड संकुचीत घटकांचें नियंत्रण आपोआप नेमपाक घटकाक data-bs-toggle="collapse"
आनी a जोडचें . data-bs-target
गुणधर्म data-bs-target
संकुचीत लागू करपाक CSS निवडक स्वीकारता. collapse
संकुचीत करपाक येवपी घटकांत वर्ग जोडपाची खात्री करात . तुमकां तो पूर्वनिर्धारीत उगडपाक जाय जाल्यार, अतिरिक्त वर्ग जोडात show
.
संकुचीत क्षेत्रांत अकॉर्डियन-सारकें गट वेवस्थापन जोडपाक, डेटा गुणधर्म जोडात data-bs-parent="#selector"
. चड म्हायती खातीर अकॉर्डियन पान पळयात .
जावास्क्रिप्ट वरवीं
हाताळणी करून सक्षम करात:
const collapseElementList = document.querySelectorAll('.collapse')
const collapseList = [...collapseElementList].map(collapseEl => new bootstrap.Collapse(collapseEl))
पर्याय आसात
पर्याय डेटा गुणधर्म वा जावास्क्रिप्ट वरवीं पास करूंक शकतात म्हणून, तुमी पर्याय नांव जोडूंक शकतात data-bs-
, जशें data-bs-animation="{value}"
. डेटा गुणधर्मां वरवीं पर्याय पास करतना पर्याय नांवाचो केस प्रकार “ camelCase ” वयल्यान “ kebab -case ” कडेन बदलपाची खात्री करात . देखीक, data-bs-custom-class="beautifier"
बदला वापरात data-bs-customClass="beautifier"
.
Bootstrap 5.2.0 प्रमाणें, सगळे घटक प्रायोगिक राखीव डेटा गुणधर्माक तेंको दितात data-bs-config
जे JSON स्ट्रिंग म्हणून सादें घटक संरचना दवरूंक शकता. जेन्ना घटकाक data-bs-config='{"delay":0, "title":123}'
आनी data-bs-title="456"
गुणधर्म आसतात, तेन्ना निमाणें title
मोल आसतलें 456
आनी वेगळे डेटा गुणधर्म चेर दिल्ल्या मोलांक अधिलिखित करतले data-bs-config
. ते भायर, सद्याचे डेटा गुणधर्म JSON मोलां सारकीं दवरपाक सक्षम आसात data-bs-delay='{"show":0,"hide":150}'
.
नांव | प्रकार | डिफॉल्ट | वर्णन |
---|---|---|---|
parent |
निवडक, डीओएम घटक | null |
जर पालक पुरवण केला जाल्यार, मागीर ही संकुचीत करपाक येवपी वस्तू दाखयल्यार निर्दिश्ट पालकाच्या खाला सगळे संकुचीत घटक बंद जातले. (पारंपारीक अकॉर्डियन वर्तना सारकें - हें card वर्गाचेर आदारून आसता). लक्ष्य संकुचीत क्षेत्राचेर गुणधर्म सेट करचें पडटा. |
toggle |
बूलियन हें नांव | true |
आवाहनाचेर संकुचीत करपाक येवपी घटक टॉगल करता. |
पद्दती
अतुल्यकालिक पद्दती आनी संक्रमण
सगळ्यो एपीआय पद्दती अतुल्यकालिक आसतात आनी संक्रमण सुरू करतात . संक्रमण सुरू जातकच पूण सोंपचे पयलीं ते फोन करप्या कडेन परततात . ते भायर, संक्रमण घटकाचेर एक पद्दत कॉल दुर्लक्षीत जातलें .
तुमची सामुग्री संकुचीत करपाक येवपी घटक म्हणून सक्रिय करता. एक पर्यायी पर्याय स्वीकारता object
.
तुमी कंस्ट्रक्टरा वांगडा संकुचीत दृष्टांत तयार करूंक शकतात, देखीक:
const bsCollapse = new bootstrap.Collapse('#myCollapse', {
toggle: false
})
पद्दत | वर्णन |
---|---|
dispose |
एका घटकाचो कोसळप नश्ट करता. (DOM घटकाचेर सांठयल्लो डेटा काडून उडयता) |
getInstance |
स्थिर पद्दत जी तुमकां DOM घटकाकडेन संबंदीत आशिल्ली संकुचीत दृष्टांत मेळोवपाक परवानगी दिता, तुमी ती अशे तरेन वापरूं येता: bootstrap.Collapse.getInstance(element) . |
getOrCreateInstance |
स्थिर पद्दत जी DOM घटकाक संबंदीत संकुचीत दृष्टांत परत दिता वा ती आरंभ करूंक नाशिल्ल्या प्रकरणांत नवी तयार करता. तुमी ताचो वापर अशे तरेन करूंक शकतात: bootstrap.Collapse.getOrCreateInstance(element) . |
hide |
संकुचीत करपाक येवपी घटक लिपयता. संकुचीत करपाक येवपी घटक प्रत्यक्षांत लिपचे पयलीं (देखीक, hidden.bs.collapse घडणूक घडचे पयलीं) कॉलराक परतता. |
show |
संकुचीत करपाक येवपी घटक दाखयता. संकुचीत करपाक येवपी घटक प्रत्यक्षांत दाखोवचे पयलीं (देखीक, shown.bs.collapse घडणूक घडचे पयलीं) कॉलराक परतता. |
toggle |
दाखोवपाक वा लिपोवन दवरपाक संकुचीत करपाक येवपी घटक टॉगल करता. संकुचीत करपाक येवपी घटक प्रत्यक्षांत दाखोवचे पयलीं वा लिपोवचे पयलीं (म्हळ्यार वा घडणूक घडचे पयलीं) कॉलराक परतता .shown.bs.collapse hidden.bs.collapse |
घडणुको
बूटस्ट्रॅपाचो कोसळपाचो वर्ग कोळसो कार्यक्षमतेक हुक करपाखातीर कांय घडणुको उक्ती करता.
इव्हेंट प्रकार | वर्णन |
---|---|
hide.bs.collapse |
hide पद्दत आपयल्या उपरांत ही घडणूक रोखडीच फायर करतात . |
hidden.bs.collapse |
वापरप्या कडल्यान संकुचीत घटक लिपला तेन्ना ही घडणूक फायर जाता (CSS संक्रमण पुराय जावपाची वाट पळयतले). |
show.bs.collapse |
show दृष्टांत पद्दत कॉल करतना ही घडणूक रोखडीच फायर जाता . |
shown.bs.collapse |
वापरप्याक कोसळपी घटक दिसपाक लायल्यार ही घडणूक फायर जाता (CSS संक्रमण पुराय जावपाची वाट पळयतले). |
const myCollapsible = document.getElementById('myCollapsible')
myCollapsible.addEventListener('hidden.bs.collapse', event => {
// do something...
})