ढहल
कुछ क्लास आ हमनी के जावास्क्रिप्ट प्लगइन के साथ अपना पूरा प्रोजेक्ट में सामग्री के दृश्यता के टॉगल करीं।
कइसे काम करेला
संकुचित जावास्क्रिप्ट प्लगइन के इस्तेमाल सामग्री देखावे आ छिपावे खातिर कइल जाला. बटन भा एंकर के इस्तेमाल ट्रिगर के रूप में कइल जाला जे आपके टॉगल करे वाला बिसेस तत्व सभ के मैप कइल जाला। कवनो तत्व के संकुचित कइला height
से ओकर वर्तमान मान से 0
. padding
ई देखत कि CSS एनीमेशन के कइसे संभाले ला, रउआँ कौनों .collapse
तत्व पर इस्तेमाल ना कर सके लीं । एकरे बजाय, क्लास के एगो स्वतंत्र रैपिंग तत्व के रूप में इस्तेमाल करीं।
prefers-reduced-motion
मीडिया क्वेरी पर निर्भर होला। हमनी के सुलभता दस्तावेज के रिड्यूस्ड मोशन सेक्शन देखल जाव
.
उदाहरण
क्लास बदलाव के माध्यम से कौनों अउरी तत्व के देखावे आ छिपावे खातिर नीचे दिहल बटन सभ पर क्लिक करीं:
.collapse
सामग्री के छिपावेला.collapsing
संक्रमण के दौरान लागू कइल जाला.collapse.show
सामग्री देखावत बा
data-bs-target
आम तौर पर, हमनी के एट्रिब्यूट वाला बटन के इस्तेमाल करे के सलाह देत बानी जा । जबकि शब्दार्थ के दृष्टिकोण से अनुशंसित ना कइल जाला, आप href
विशेषता (आ एगो 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
संक्रमण करे खातिर संशोधक वर्ग जोड़ीं आ तत्काल चाइल्ड तत्व पर a सेट करीं । बेझिझक आपन कस्टम Sass लिखीं, इनलाइन शैली के इस्तेमाल करीं, भा हमनी के चौड़ाई उपयोगिता के इस्तेमाल करीं .width
height
width
min-height
में हमनी के डॉक्स में बेसी रिपेंट से बचे खातिर सेट बा, एकर स्पष्ट रूप से जरूरी नइखे।
खाली width
ऑन द चाइल्ड तत्व के जरूरत बा।
<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>
कई गो निशाना बनावल गइल बा
ए <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"
एकरे बजाय नियंत्रण पर सेट करीं। प्लगइन एह बिसेसता के नियंत्रण पर स्वचालित रूप से टॉगल करी जे एह आधार पर होखी कि संकुचन करे लायक तत्व खोलल गइल बा कि ना (जावास्क्रिप्ट के माध्यम से, या एह से कि प्रयोगकर्ता कौनों अउरी नियंत्रण तत्व के ट्रिगर कइले बा जे ओही संकुचित तत्व से भी जुड़ल बा)। अगर कंट्रोल एलिमेंट के एचटीएमएल एलिमेंट बटन ना होखे (जइसे कि, एगो <a>
या <div>
), त एट्रिब्यूटrole="button"
तत्व में जोड़ल जाव.
अगर राउर नियंत्रण तत्व कवनो एकल संकुचित तत्व के लक्षित कर रहल बा – यानी विशेषता कवनो चयनकर्ता data-bs-target
के ओर इशारा कर रहल बा – त रउआ विशेषता के नियंत्रण तत्व में जोड़ल जाव, जवना में संकुचित तत्व के होखे। आधुनिक स्क्रीन रीडर आ अइसने सहायक तकनीक सभ एह बिसेसता के इस्तेमाल करे लीं जेह से कि प्रयोगकर्ता लोग के खुद संकुचित तत्व पर सीधे नेविगेट करे खातिर अतिरिक्त शॉर्टकट उपलब्ध करावल जा सके।id
aria-controls
id
ध्यान दीं कि बूटस्ट्रैप के वर्तमान कार्यान्वयन में एरिया ऑथरिग प्रैक्टिस गाइड अकॉर्डियन पैटर्न में वर्णित बिबिध वैकल्पिक कीबोर्ड इंटरैक्शन सभ के कवर ना कइल गइल बा - रउआँ के खुद कस्टम जावास्क्रिप्ट के साथ इनहन के शामिल करे के पड़ी।
ससस के बा
चर के बारे में बतावल गइल बा
$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
संक्रमण शुरू होखे पर जोड़ल जाला, आ खतम होखे पर हटा दिहल जाला
ई कक्षा 2018 में मिल सकेला _transitions.scss
।
डेटा विशेषता के माध्यम से कइल जाला
बस तत्व में data-bs-toggle="collapse"
आ एगो जोड़ दीं जेह data-bs-target
से कि एक या एक से ढेर संकुचन योग्य तत्व सभ के नियंत्रण स्वचालित रूप से असाइन कइल जा सके। एट्रिब्यूट एगो CSS चयनकर्ता के स्वीकार करे ला जेकरा data-bs-target
पर कोलैप्स लागू कइल जा सके ला। 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 ” से “ कबाब-केस ” में बदलल सुनिश्चित करीं । जइसे कि के data-bs-custom-class="beautifier"
जगह पर इस्तेमाल करीं data-bs-customClass="beautifier"
.
बूटस्ट्रैप 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...
})