संकुचित करा

हे कसे कार्य करते

संकुचित JavaScript प्लगइन सामग्री दर्शविण्यासाठी आणि लपवण्यासाठी वापरले जाते. बटणे किंवा अँकर ट्रिगर म्हणून वापरले जातात जे तुम्ही टॉगल करता त्या विशिष्ट घटकांवर मॅप केले जातात. घटक संकुचित केल्याने heightत्याचे वर्तमान मूल्य ते अॅनिमेट होईल 0. CSS अॅनिमेशन कसे हाताळते ते दिले, तुम्ही घटकावर वापरू शकत paddingनाही .collapse. त्याऐवजी, स्वतंत्र रॅपिंग घटक म्हणून वर्ग वापरा.

उदाहरण

वर्ग बदलांद्वारे दुसरा घटक दर्शविण्यासाठी आणि लपवण्यासाठी खालील बटणावर क्लिक करा:

• .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संक्रमण करण्यासाठी सुधारक वर्ग जोडा आणि तात्काळ चाइल्ड घटकावर सेट करा. तुमचा स्वतःचा सानुकूल Sass लिहायला मोकळ्या मनाने, इनलाइन शैली वापरा किंवा आमच्या रुंदीच्या उपयुक्तता वापरा .widthheightwidth

<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 घटक बटण नसल्यास (उदा. an <a>किंवा <div>), विशेषताrole="button"घटकात जोडले पाहिजे.

जर तुमचा कंट्रोल एलिमेंट एकाच कोलॅप्सिबल एलिमेंटला टार्गेट करत असेल - म्हणजे data-bs-targetअॅट्रीब्युट idसिलेक्टरला पॉइंट करत असेल तर - तुम्ही aria-controlsकंट्रोल एलिमेंटमध्ये अॅट्रिब्यूट जोडले पाहिजे, ज्यामध्ये idकोलॅप्सिबल एलिमेंट असेल. आधुनिक स्क्रीन रीडर आणि तत्सम सहाय्यक तंत्रज्ञान वापरकर्त्यांना थेट संकुचित घटकावर नेव्हिगेट करण्यासाठी अतिरिक्त शॉर्टकट प्रदान करण्यासाठी या गुणधर्माचा वापर करतात.

लक्षात घ्या की बूटस्ट्रॅपच्या सध्याच्या अंमलबजावणीमध्ये 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 जोडा. कोलॅप्स लागू करण्यासाठी विशेषता CSS निवडक स्वीकारते data-bs-target. संकुचित घटकामध्ये data-bs-targetवर्ग जोडण्याची खात्री करा . collapseतुम्हाला ते डीफॉल्ट उघडायचे असल्यास, अतिरिक्त वर्ग जोडा show.

संकुचित क्षेत्रामध्ये एकॉर्डियन सारखे गट व्यवस्थापन जोडण्यासाठी, डेटा विशेषता जोडा data-bs-parent="#selector". अधिक माहितीसाठी एकॉर्डियन पृष्ठाचा संदर्भ घ्या .

JavaScript द्वारे

यासह व्यक्तिचलितपणे सक्षम करा:

const collapseElementList = document.querySelectorAll('.collapse')
const collapseList = [...collapseElementList].map(collapseEl => new bootstrap.Collapse(collapseEl))

पर्याय

data-bs-पर्याय डेटा विशेषता किंवा JavaScript द्वारे पास केले जाऊ शकतात म्हणून, तुम्ही मध्ये पर्याय नाव जोडू शकता data-bs-animation="{value}". डेटा विशेषतांद्वारे पर्याय पास करताना पर्याय नावाचा केस प्रकार “ camelCase ” वरून “ kebab-case ” मध्ये बदलण्याची खात्री करा. उदाहरणार्थ, 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}'.

पद्धती

तुमची सामग्री संकुचित करण्यायोग्य घटक म्हणून सक्रिय करते. पर्यायी पर्याय स्वीकारतो object.

तुम्ही कन्स्ट्रक्टरसह संकुचित उदाहरण तयार करू शकता, उदाहरणार्थ:

const bsCollapse = new bootstrap.Collapse('#myCollapse', {
  toggle: false
})

कार्यक्रम

बूटस्ट्रॅपचा कोलॅप्स क्लास कोलॅप्स फंक्शनॅलिटीमध्ये जोडण्यासाठी काही इव्हेंट्स उघड करतो.

const myCollapsible = document.getElementById('myCollapsible')
myCollapsible.addEventListener('hidden.bs.collapse', event => {
  // do something...
})