संश्यान
कतिपयैः वर्गैः अस्माकं जावास्क्रिप्ट् प्लगिन्स् इत्यनेन च स्वस्य परियोजनायां सामग्रीयाः दृश्यतां टॉगल कुर्वन्तु ।
कथं कार्यं करोति
सामग्रीं दर्शयितुं गोपनार्थं च collapse JavaScript प्लगिन् उपयुज्यते । बटन्स् अथवा एङ्कर्स् इत्यस्य उपयोगः ट्रिगर् इत्यस्य रूपेण भवति ये भवता टॉग्ल् कृत्वा विशिष्टतत्त्वेषु मैप् कृताः भवन्ति । तत्त्वं संकुचितं कृत्वा height
तस्य वर्तमानमूल्यात् 0
. padding
CSS एनिमेशनं कथं सम्पादयति इति दृष्ट्वा, भवान् कस्मिंश्चित् .collapse
तत्त्वे उपयोक्तुं न शक्नोति । अपि तु स्वतन्त्रं वेष्टनतत्त्वरूपेण वर्गस्य उपयोगं कुर्वन्तु ।
prefers-reduced-motion
मीडिया-प्रश्नस्य उपरि निर्भरः भवति । अस्माकं सुलभतादस्तावेजस्य न्यूनीकृतगतिविभागं पश्यन्तु
.
उदाहरण
वर्गपरिवर्तनद्वारा अन्यं तत्त्वं दर्शयितुं गोपयितुं च अधोलिखितानि बटन्स् नुदन्तु:
.collapse
सामग्रीं गोपयति.collapsing
संक्रमणकाले प्रयुक्तः भवति.collapse.show
सामग्रीं दर्शयति
data-target
सामान्यतया, वयं विशेषतायुक्तस्य बटनस्य उपयोगं अनुशंसयामः । href
यद्यपि शब्दार्थदृष्ट्या अनुशंसितं न भवति तथापि विशेषता (तथा a ) इत्यनेन सह लिङ्क् अपि उपयोक्तुं शक्नुवन्ति role="button"
। उभयत्र data-toggle="collapse"
अपेक्षितम् इति ।
<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>
क्षैतिज
collapse प्लगिन् क्षैतिज collapsing अपि समर्थयति । instead of इत्यस्य .width
संक्रमणार्थं modifier क्लास् योजयन्तु तथा च तत्कालं child element इत्यत्र a सेट् कुर्वन्तु । स्वकीयं कस्टम् Sass लिखितुं, इनलाइनशैल्याः उपयोगं कर्तुं, अथवा अस्माकं width utilities इत्यस्य उपयोगं कर्तुं निःशङ्कं भवन्तु .width
height
width
min-height
अस्माकं docs मध्ये अत्यधिकं पुनः रङ्गं न कर्तुं सेट् अस्ति तथापि एतत् स्पष्टतया आवश्यकं नास्ति ।
केवलं width
on the child इति तत्वम् आवश्यकम् अस्ति ।
<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>
अनेक लक्ष्य
A <button>
or इत्यस्य or attribute <a>
इत्यस्मिन् JQuery selector इत्यनेन सह सन्दर्भयित्वा बहुविधतत्त्वानि दर्शयितुं गोपयितुं च शक्नोति । बहु वा एकं तत्त्वं दर्शयितुं गोपयितुं च शक्नुवन्ति यदि ते प्रत्येकं स्वस्य वा विशेषतायाः सह तस्य सन्दर्भं ददतिhref
data-target
<button>
<a>
href
data-target
प्रथमं तत्त्वं टॉगलं कुर्वन्तु
<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>
अकॉर्डियन उदाहरण
कार्ड घटकस्य उपयोगेन , भवान् पूर्वनिर्धारितं संकुचनव्यवहारं विस्तारयितुं अकॉर्डियनं निर्मातुम् अर्हति । अकॉर्डियन शैलीं सम्यक् प्राप्तुं, अवश्यमेव .accordion
आवरणरूपेण उपयोगं कुर्वन्तु ।
.show
वर्गस्य धन्यवादेन ।
<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>
सुलभता
aria-expanded
नियन्त्रणतत्त्वे अवश्यं योजयन्तु । एतत् विशेषता स्पष्टतया स्क्रीन रीडर् तथा तत्सदृशसहायकप्रौद्योगिकीभ्यः नियन्त्रणेन सह बद्धस्य संकुचनीयतत्त्वस्य वर्तमानस्थितिं प्रसारयति यदि संकुचनीयं तत्त्वं पूर्वनिर्धारितरूपेण बन्दं भवति तर्हि नियन्त्रणतत्त्वे विशेषतायाः मूल्यं भवितव्यम् aria-expanded="false"
। show
यदि भवान् वर्गस्य उपयोगेन पूर्वनिर्धारितरूपेण संकुचनीयं तत्त्वं उद्घाटयितुं सेट् aria-expanded="true"
कृतवान् तर्हि तस्य स्थाने नियन्त्रणे सेट् कुर्वन्तु । प्लगिन् स्वयमेव एतत् विशेषतां नियन्त्रणे टोग्ल् करिष्यति यत् संकुचनीयतत्त्वं उद्घाटितं वा बन्दं वा (जावास्क्रिप्ट् मार्गेण, अथवा यतः उपयोक्ता अन्यं नियन्त्रणतत्त्वं अपि तस्मिन् एव संकुचनीयतत्त्वे बद्धं प्रेरितवान्) इति आधारेण यदि नियन्त्रणतत्त्वस्य HTML तत्त्वं बटनं नास्ति (उदा., an <a>
or <div>
), तर्हि विशेषताrole="button"
तत्त्वं योजयेत् ।
यदि भवतां नियन्त्रणतत्त्वं एकं संकुचनीयं तत्त्वं लक्ष्यं करोति – अर्थात् data-target
विशेषता चयनकर्तारं दर्शयति – तर्हि भवान् नियन्त्रणतत्त्वे विशेषतां id
योजयितव्यं , यत्र संकुचनीयतत्त्वस्य the भवति आधुनिकस्क्रीन् रीडर् तथा तत्सदृशाः सहायकप्रौद्योगिकयः अस्य विशेषतायाः उपयोगं कुर्वन्ति यत् उपयोक्तृभ्यः संकुचनीयतत्त्वे एव प्रत्यक्षतया गन्तुं अतिरिक्तशॉर्टकट् प्रदातुं शक्नुवन्तिaria-controls
id
ध्यानं कुर्वन्तु यत् Bootstrap इत्यस्य वर्तमानकार्यन्वयनं ARIA Authoring Practices Guide accordion pattern इत्यस्मिन् वर्णितानि विविधानि कीबोर्ड-अन्तर्क्रियाः न आच्छादयति - भवद्भिः एतानि स्वयमेव कस्टम् JavaScript इत्यनेन सह समाविष्टानि कर्तव्यानि भविष्यन्ति
प्रयोगः
पतनप्लगिन् भारी उत्थापनं नियन्त्रयितुं कतिपयान् वर्गान् उपयुज्यते:
.collapse
सामग्रीं गोपयति.collapse.show
सामग्रीं दर्शयति.collapsing
संक्रमणस्य आरम्भे योजितः भवति, समाप्तौ च निष्कासितः भवति
एते वर्गाः _transitions.scss
.
डेटा विशेषताओं के माध्यम से
केवलं एकस्य वा अधिकस्य वा संकुचनीयस्य तत्त्वस्य नियन्त्रणं स्वयमेव नियुक्तुं तत्त्वे data-toggle="collapse"
and a योजयन्तु । विशेषणं संकुचनं प्रयोक्तुं CSS चयनकर्तारं स्वीकुर्वति data-target
। संकुचनीयतत्त्वे data-target
वर्गं अवश्यं योजयन्तु । collapse
यदि भवान् इदं पूर्वनिर्धारितरूपेण उद्घाटितुम् इच्छति तर्हि अतिरिक्तवर्गं योजयन्तु show
.
संकुचनीयक्षेत्रे accordion-सदृशं समूहप्रबन्धनं योजयितुं, data attribute योजयन्तु data-parent="#selector"
। एतत् कार्ये द्रष्टुं डेमो पश्यन्तु।
जावास्क्रिप्ट् मार्गेण
सह मैन्युअल् रूपेण सक्षमं कुर्वन्तु:
$('.collapse').collapse()
विकल्पाः
विकल्पाः data attributes अथवा JavaScript मार्गेण पारयितुं शक्यन्ते । दत्तांशविशेषतानां कृते, विकल्पनाम , इत्यत्र data-
योजयन्तु data-parent=""
।
नामः | प्रकारः | मूलभूतम् | वर्णनम् |
---|---|---|---|
माता पिता | चयनकर्ता | jQuery वस्तु | DOM तत्वम् | असत्य | यदि parent प्रदत्तं भवति, तर्हि निर्दिष्टस्य parent इत्यस्य अधः सर्वे संकुचनीयाः तत्त्वानि बन्दं भविष्यन्ति यदा एतत् संकुचनीयं द्रव्यं दर्शितं भवति । (पारम्परिक-अकॉर्डियन-व्यवहारस्य सदृशम् - एतत् वर्गाश्रितम् अस्ति card )। लक्ष्यसंकुचनीयक्षेत्रे विशेषतां सेट् कर्तव्यम् अस्ति । |
toggle इति | बूलियन इति | सत्यम् | आह्वानसमये संकुचनीयं तत्त्वं टॉगलं करोति |
विधियाँ
अतुल्यकालिक विधियाँ एवं संक्रमण
सर्वे एपिआइ विधिः अतुल्यकालिकः भवति तथा च संक्रमणं आरभते | ते संक्रमणस्य आरम्भमात्रेण परन्तु तस्य समाप्तेः पूर्वं आह्वानकर्तुः समीपं आगच्छन्ति | तदतिरिक्तं, संक्रमणघटकस्य उपरि एकः विधि-आह्वानः अवहेलितः भविष्यति .
.collapse(options)
Activates your content as a collapsible element. Accepts an optional options object
.
$('#myCollapsible').collapse({
toggle: false
})
.collapse('toggle')
Toggles a collapsible element to shown or hidden. Returns to the caller before the collapsible element has actually been shown or hidden (i.e. before the shown.bs.collapse
or hidden.bs.collapse
event occurs).
.collapse('show')
Shows a collapsible element. Returns to the caller before the collapsible element has actually been shown (i.e. before the shown.bs.collapse
event occurs).
.collapse('hide')
Hides a collapsible element. Returns to the caller before the collapsible element has actually been hidden (i.e. before the hidden.bs.collapse
event occurs).
.collapse('dispose')
Destroys an element’s collapse.
Events
Bootstrap’s collapse class exposes a few events for hooking into collapse functionality.
Event Type | Description |
---|---|
show.bs.collapse | एषा घटना तत्क्षणमेव प्रज्वलति यदा show दृष्टान्तविधिः आह्वयते । |
दर्शितम्.bs.collapse इति | इदं घटना तदा प्रज्वलितं भवति यदा उपयोक्त्रे दृश्यमानं संकुचनतत्त्वं कृतम् अस्ति (CSS संक्रमणानां पूर्णतां प्रतीक्षते) । |
hide.bs.collapse इति | hide विधि आहूते सद्यः एषा घटना प्रज्वलिता भवति । |
hidden.bs.collapse इति | एषा घटना तदा प्रज्वलितः भवति यदा उपयोक्त्रेण संक्षेपतत्त्वं निगूढं भवति (CSS संक्रमणानां पूर्णतां प्रतीक्षते) । |
$('#myCollapsible').on('hidden.bs.collapse', function () {
// do something...
})