හකුළන්න

එය ක්රියා කරන ආකාරය

බිඳවැටීමේ 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>තේරීම්කාරකයක් සමඟ යොමු කිරීමෙන් ඒවා පෙන්වීමට සහ සැඟවීමට හැකිය . බහුවිධ හෝ ඒවා එක් එක් මූලද්‍රව්‍යයක් ඒවායේ හෝ ගුණාංගය සමඟ යොමු කරන්නේ නම් එය පෙන්වීමට සහ සැඟවීමට හැකියhrefdata-bs-target<button><a>hrefdata-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"ඒ වෙනුවට පාලනය මත සකසන්න. ප්ලගිනය මෙම ගුණාංගය ස්වයංක්‍රීයව පාලනය මත ටොගල් කරනු ඇත (JavaScript හරහා, හෝ පරිශීලකයා එම කඩාවැටිය හැකි මූලද්‍රව්‍යයට බැඳී ඇති වෙනත් පාලන මූලද්‍රව්‍යයක් ක්‍රියාකරවීම නිසා). පාලන මූලද්‍රව්‍යයේ HTML මූලද්‍රව්‍යය බොත්තමක් නොවේ නම් (උදා, a <a>හෝ <div>), ගුණාංගයrole="button"මූලද්රව්යයට එකතු කළ යුතුය.

ඔබේ පාලන මූලද්‍රව්‍ය තනි බිඳවැටිය හැකි මූලද්‍රව්‍යයක් ඉලක්ක කරන්නේ නම් - එනම් data-bs-targetගුණාංගය idතේරීම් කාරකයක් වෙත යොමු කරයි නම් - ඔබ කඩාවැටෙන aria-controlsමූලද්‍රව්‍ය අඩංගු පාලන මූලද්‍රව්‍යයට ගුණාංගය එක් කළ යුතුය id. නවීන තිර කියවනය සහ ඒ හා සමාන උපකාරක තාක්ෂණයන් මෙම ගුණාංගය භාවිතා කර පරිශීලකයින්ට කඩාවැටෙන මූලද්‍රව්‍ය වෙත කෙලින්ම සැරිසැරීමට අමතර කෙටිමං ලබා දෙයි.

Bootstrap හි වත්මන් ක්‍රියාත්මක කිරීම ARIA Authoring Practices Guide Accordion රටාවේ විස්තර කර ඇති විවිධ විකල්ප යතුරුපුවරු අන්තර්ක්‍රියා ආවරණය නොකරන බව සලකන්න - ඔබට අභිරුචි ජාවාස්ක්‍රිප්ට් සමඟ මේවා ඔබම ඇතුළත් කිරීමට අවශ්‍ය වනු ඇත.

සාස්

විචල්යයන්

$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.

කඩා වැටෙන ප්‍රදේශයකට Accordion වැනි සමූහ කළමනාකරණය එක් කිරීමට, දත්ත ගුණාංගය එක් කරන්න data-bs-parent="#selector". වෙත යොමු කරන්න Accordion පිටුව බලන්න .

JavaScript හරහා

සමඟ අතින් සබල කරන්න:

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

විකල්ප

දත්ත උපලක්ෂණ හෝ ජාවාස්ක්‍රිප්ට් හරහා විකල්ප ලබා දිය හැකි බැවින්, ඔබට විකල්ප නාමයක් data-bs-, ලෙසට එකතු කළ හැක data-bs-animation="{value}". දත්ත ගුණාංග හරහා විකල්ප සම්මත කිරීමේදී විකල්ප නාමයේ කේස් වර්ගය “ කැමල්කේස් ” සිට “ කෙබාබ්-කේස් ” ලෙස වෙනස් කිරීමට වග බලා ගන්න. උදාහරණයක් ලෙස, data-bs-custom-class="beautifier"වෙනුවට භාවිතා කරන්න data-bs-customClass="beautifier".

Bootstrap 5.2.0 වන විට, සියලුම සංරචක JSON තන්තුවක් ලෙස සරල සංරචක වින්‍යාසගත කළ හැකි පර්යේෂණාත්මක වෙන් කළ දත්ත ගුණාංගයකට සහාය දක්වයි. data-bs-configමූලද්‍රව්‍යයක් සතුව 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
})

සිදුවීම්

Bootstrap හි කඩා වැටීමේ පන්තිය බිඳ වැටීමේ ක්‍රියාකාරීත්වයට සම්බන්ධ වීම සඳහා සිදුවීම් කිහිපයක් නිරාවරණය කරයි.

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