முக்கிய உள்ளடக்கத்திற்கு செல்க டாக்ஸ் வழிசெலுத்தலுக்குச் செல்லவும்
in English

சுருக்கு

சில வகுப்புகள் மற்றும் எங்கள் ஜாவாஸ்கிரிப்ட் செருகுநிரல்கள் மூலம் உங்கள் திட்டம் முழுவதும் உள்ளடக்கத்தின் தெரிவுநிலையை மாற்றவும்.

எப்படி இது செயல்படுகிறது

உள்ளடக்கத்தைக் காட்ட மற்றும் மறைக்க ஜாவாஸ்கிரிப்ட் செருகுநிரல் பயன்படுத்தப்படுகிறது. பொத்தான்கள் அல்லது நங்கூரங்கள் தூண்டுதல்களாகப் பயன்படுத்தப்படுகின்றன, அவை நீங்கள் மாற்றும் குறிப்பிட்ட உறுப்புகளுக்கு வரைபடமாக்கப்படுகின்றன. ஒரு உறுப்பைச் சுருக்கினால், heightஅதன் தற்போதைய மதிப்பிலிருந்து 0. CSS அனிமேஷன்களை எவ்வாறு கையாளுகிறது என்பதைக் கருத்தில் கொண்டு, நீங்கள் paddingஒரு .collapseஉறுப்பில் பயன்படுத்த முடியாது. அதற்கு பதிலாக, வகுப்பை ஒரு சுயாதீன மடக்குதல் உறுப்பாகப் பயன்படுத்தவும்.

இந்தக் கூறுகளின் அனிமேஷன் விளைவு prefers-reduced-motionமீடியா வினவலைச் சார்ந்தது. எங்கள் அணுகல்தன்மை ஆவணத்தின் குறைக்கப்பட்ட இயக்கம் பகுதியைப் பார்க்கவும் .

உதாரணமாக

வகுப்பு மாற்றங்கள் மூலம் மற்றொரு உறுப்பைக் காட்டவும் மறைக்கவும் கீழே உள்ள பொத்தான்களைக் கிளிக் செய்யவும்:

  • .collapseஉள்ளடக்கத்தை மறைக்கிறது
  • .collapsingமாற்றங்களின் போது பயன்படுத்தப்படுகிறது
  • .collapse.showஉள்ளடக்கத்தைக் காட்டுகிறது

data-bs-targetபொதுவாக, பண்புக்கூறுடன் ஒரு பொத்தானைப் பயன்படுத்த பரிந்துரைக்கிறோம் . சொற்பொருள் பார்வையில் இருந்து பரிந்துரைக்கப்படவில்லை என்றாலும், hrefபண்புக்கூறுடன் (மற்றும் a role="button") இணைப்பையும் நீங்கள் பயன்படுத்தலாம். இரண்டு சந்தர்ப்பங்களிலும், data-bs-toggle="collapse"தேவை.

Some placeholder content for the collapse component. This panel is hidden by default but revealed when the user activates the relevant trigger.
<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>

பல இலக்குகள்

A <button>அல்லது பல கூறுகளை அதன் அல்லது பண்புக்கூறில் <a>ஒரு தேர்வாளருடன் குறிப்பிடுவதன் மூலம் அவற்றைக் காட்டலாம் மற்றும் மறைக்கலாம் . பல அல்லது அவை ஒவ்வொன்றும் ஒரு உறுப்பை அவற்றின் அல்லது பண்புக்கூறுடன் குறிப்பிட்டால் அதைக் காட்டலாம் மற்றும் மறைக்கலாம்hrefdata-bs-target<button><a>hrefdata-bs-target

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.
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.
<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. நவீன ஸ்க்ரீன் ரீடர்கள் மற்றும் அதுபோன்ற உதவித் தொழில்நுட்பங்கள் பயனர்களுக்கு மடிக்கக்கூடிய உறுப்புக்கு நேரடியாகச் செல்ல கூடுதல் குறுக்குவழிகளை வழங்க இந்தப் பண்புக்கூறைப் பயன்படுத்துகின்றன.

WAI-ARIA ஆதரிங் நடைமுறைகள் 1.1 துருத்தி வடிவில் விவரிக்கப்பட்டுள்ள பல்வேறு விருப்ப விசைப்பலகை தொடர்புகளை பூட்ஸ்டார்ப்பின் தற்போதைய செயலாக்கம் உள்ளடக்காது என்பதை நினைவில் கொள்ளவும் - தனிப்பயன் ஜாவாஸ்கிரிப்டுடன் இவற்றை நீங்களே சேர்க்க வேண்டும்.

சாஸ்

மாறிகள்

$transition-collapse:         height .35s ease;

வகுப்புகள்

scss/_transitions.scssபல கூறுகளில் (சரிவு மற்றும் துருத்தி) பகிரப்படுவதால், சுருக்க மாறுதல் வகுப்புகளைக் காணலாம் .

.collapse {
  &:not(.show) {
    display: none;
  }
}

.collapsing {
  height: 0;
  overflow: hidden;
  @include transition($transition-collapse);
}

பயன்பாடு

சரிவு சொருகி கனமான தூக்குதலைக் கையாள சில வகுப்புகளைப் பயன்படுத்துகிறது:

  • .collapseஉள்ளடக்கத்தை மறைக்கிறது
  • .collapse.showஉள்ளடக்கத்தைக் காட்டுகிறது
  • .collapsingமாற்றம் தொடங்கும் போது சேர்க்கப்படும், அது முடிந்ததும் அகற்றப்படும்

இந்த வகுப்புகளை இதில் காணலாம் _transitions.scss.

தரவு பண்புக்கூறுகள் மூலம்

ஒன்று அல்லது அதற்கு மேற்பட்ட மடிக்கக்கூடிய உறுப்புகளின் கட்டுப்பாட்டை தானாக ஒதுக்க, உறுப்பில் data-bs-toggle="collapse"ஒரு சேர்க்கவும் . data-bs-targetபண்புக்கூறு சுருக்கத்தைப் data-bs-targetபயன்படுத்த CSS தேர்வியை ஏற்றுக்கொள்கிறது. collapseமடிக்கக்கூடிய உறுப்புடன் வகுப்பைச் சேர்க்க மறக்காதீர்கள் . இது இயல்புநிலையாகத் திறக்கப்பட வேண்டுமெனில், கூடுதல் வகுப்பைச் சேர்க்கவும் show.

மடிக்கக்கூடிய பகுதிக்கு துருத்தி போன்ற குழு நிர்வாகத்தைச் சேர்க்க, தரவுப் பண்புக்கூறைச் சேர்க்கவும் data-bs-parent="#selector". இதை செயலில் காண டெமோவைப் பார்க்கவும்.

ஜாவாஸ்கிரிப்ட் வழியாக

இதனுடன் கைமுறையாக இயக்கு:

var collapseElementList = [].slice.call(document.querySelectorAll('.collapse'))
var collapseList = collapseElementList.map(function (collapseEl) {
  return new bootstrap.Collapse(collapseEl)
})

விருப்பங்கள்

தரவு பண்புக்கூறுகள் அல்லது ஜாவாஸ்கிரிப்ட் மூலம் விருப்பங்களை அனுப்பலாம். data-bs-தரவு பண்புக்கூறுகளுக்கு, இல் உள்ளதைப் போல விருப்பப் பெயரைச் சேர்க்கவும் data-bs-parent="".

பெயர் வகை இயல்புநிலை விளக்கம்
parent தேர்வாளர் | jQuery பொருள் | DOM உறுப்பு false பெற்றோர் வழங்கப்பட்டிருந்தால், இந்த மடிக்கக்கூடிய உருப்படி காட்டப்படும்போது, ​​குறிப்பிட்ட பெற்றோரின் கீழ் அனைத்து மடிக்கக்கூடிய கூறுகளும் மூடப்படும். card(பாரம்பரிய துருத்தி நடத்தை போன்றது - இது வகுப்பைச் சார்ந்தது ). இலக்கு மடிக்கக்கூடிய பகுதியில் பண்புக்கூறு அமைக்கப்பட வேண்டும்.
toggle பூலியன் true அழைப்பின் போது மடிக்கக்கூடிய உறுப்பை மாற்றுகிறது

முறைகள்

ஒத்திசைவற்ற முறைகள் மற்றும் மாற்றங்கள்

அனைத்து API முறைகளும் ஒத்திசைவற்றவை மற்றும் மாற்றத்தைத் தொடங்குகின்றன . மாற்றம் தொடங்கப்பட்டவுடன், ஆனால் அது முடிவதற்குள் அவர்கள் அழைப்பாளரிடம் திரும்புகிறார்கள் . கூடுதலாக, மாற்றும் கூறுகளின் முறை அழைப்பு புறக்கணிக்கப்படும் .

மேலும் தகவலுக்கு எங்கள் ஜாவாஸ்கிரிப்ட் ஆவணங்களைப் பார்க்கவும் .

உங்கள் உள்ளடக்கத்தை மடிக்கக்கூடிய உறுப்பாக செயல்படுத்துகிறது. விருப்ப விருப்பங்களை ஏற்றுக்கொள்கிறது object.

நீங்கள் கன்ஸ்ட்ரக்டருடன் சரிவு நிகழ்வை உருவாக்கலாம், எடுத்துக்காட்டாக:

var myCollapse = document.getElementById('myCollapse')
var bsCollapse = new bootstrap.Collapse(myCollapse, {
  toggle: false
})
முறை விளக்கம்
toggle மடிக்கக்கூடிய உறுப்பைக் காட்ட அல்லது மறைக்க மாற்றுகிறது. மடக்கக்கூடிய உறுப்பு உண்மையில் காட்டப்படுவதற்கு அல்லது மறைக்கப்படுவதற்கு முன்பு (அதாவது நிகழ்வு shown.bs.collapseஅல்லது hidden.bs.collapseநிகழ்வு நிகழும் முன்) அழைப்பாளருக்குத் திரும்பும்.
show மடிக்கக்கூடிய உறுப்பைக் காட்டுகிறது. மடிக்கக்கூடிய உறுப்பு உண்மையில் காட்டப்படுவதற்கு முன்பு அழைப்பாளருக்குத் திரும்புகிறது (எ.கா. shown.bs.collapseநிகழ்வு நிகழும் முன்).
hide மடிக்கக்கூடிய உறுப்பை மறைக்கிறது. மடிக்கக்கூடிய உறுப்பு உண்மையில் மறைக்கப்படுவதற்கு முன்பு அழைப்பாளருக்குத் திரும்பும் (எ.கா. hidden.bs.collapseநிகழ்வு நிகழும் முன்).
dispose ஒரு தனிமத்தின் சரிவை அழிக்கிறது. (DOM உறுப்பில் சேமிக்கப்பட்ட தரவை நீக்குகிறது)
getInstance DOM உறுப்புடன் தொடர்புடைய சரிவு நிகழ்வைப் பெற உங்களை அனுமதிக்கும் நிலையான முறை, இதை நீங்கள் இப்படிப் பயன்படுத்தலாம்:bootstrap.Collapse.getInstance(element)
getOrCreateInstance DOM உறுப்புடன் தொடர்புடைய சரிவு நிகழ்வை வழங்கும் நிலையான முறை அல்லது அது துவக்கப்படாவிட்டால் புதிய ஒன்றை உருவாக்குகிறது. நீங்கள் இதை இப்படி பயன்படுத்தலாம்:bootstrap.Collapse.getOrCreateInstance(element)

நிகழ்வுகள்

பூட்ஸ்ட்ராப்பின் சரிவு வகுப்பு, சரிவு செயல்பாட்டில் இணைக்கும் சில நிகழ்வுகளை வெளிப்படுத்துகிறது.

நிகழ்வு வகை விளக்கம்
show.bs.collapse showநிகழ்வு முறை என்று அழைக்கப்படும் போது இந்த நிகழ்வு உடனடியாக சுடுகிறது .
shown.bs.collapse ஒரு சரிவு உறுப்பு பயனருக்குத் தெரியும் போது இந்த நிகழ்வு நீக்கப்படும் (CSS மாற்றங்கள் முடிவடையும் வரை காத்திருக்கும்).
hide.bs.collapse hideமுறை அழைக்கப்படும் போது இந்த நிகழ்வு உடனடியாக நீக்கப்பட்டது .
hidden.bs.collapse ஒரு சரிவு உறுப்பு பயனரிடமிருந்து மறைக்கப்படும்போது இந்த நிகழ்வு நீக்கப்படும் (CSS மாற்றங்கள் முடிவடையும் வரை காத்திருக்கும்).
var myCollapsible = document.getElementById('myCollapsible')
myCollapsible.addEventListener('hidden.bs.collapse', function () {
  // do something...
})