Source

Колапс

Укључите видљивост садржаја у свом пројекту помоћу неколико класа и наших ЈаваСцрипт додатака.

Како то ради

ЈаваСцрипт додатак за колапс се користи за приказивање и сакривање садржаја. Дугмад или сидра се користе као окидачи који су мапирани на одређене елементе које пребацујете. Сажимањем елемента ће се анимирати heightса његове тренутне вредности на 0. С обзиром на то како ЦСС рукује анимацијама, не можете користити paddingна .collapseелементу. Уместо тога, користите класу као независни елемент омотача.

Ефекат анимације ове компоненте зависи од prefers-reduced-motionмедијског упита. Погледајте одељак о смањеном покрету наше документације о приступачности .

Пример

Кликните на дугмад испод да бисте приказали и сакрили други елемент путем промена класе:

  • .collapseскрива садржај
  • .collapsingпримењује се током прелаза
  • .collapse.showприказује садржај

Можете користити везу са hrefатрибутом или дугме са data-targetатрибутом. У оба случаја data-toggle="collapse"је потребно.

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. 
<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">
    Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
  </div>
</div>

Више мета

А <button>или <a>може приказати и сакрити више елемената упућивањем на њих помоћу ЈКуери селектора у свом hrefили data-targetатрибуту. Вишеструки <button>или <a>могу да прикажу и сакрију елемент ако сваки од њих референцира са својим hrefили data-targetатрибутом

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. 
<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">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
      </div>
    </div>
  </div>
  <div class="col">
    <div class="collapse multi-collapse" id="multiCollapseExample2">
      <div class="card card-body">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident.
      </div>
    </div>
  </div>
</div>

Пример хармонике

Користећи компоненту картице , можете проширити подразумевано понашање сажимања да бисте направили хармонику. Да бисте правилно постигли стил хармонике, обавезно користите .accordionкао омот.

Аним париатур цлицхе репрехендерит, еним еиусмод хигх лифе оптужба Терри рицхардсон ад лигње. 3 волф моон оффициа ауте, нон цупидатат скатебоард долор брунцх. Камион за храну куиноа несциунт лаборум еиусмод. Брунцх 3 волф моон темпор, сунт аликуа ставио птицу на то лигње кафа једног порекла нулла аццептнда схоредитцх ет. Нихил аним кеффииех хелветица, црафт пиво лаборе вес андерсон цред несциунт сапиенте еа проидент. Ад веган осим месар вице ломо. Хеланке оццаецат црафт пиво од фарме до стола, сирови деним естетски синтисајзер несциунт за које вероватно нисте чули Аццузамус Лабе сустаинабле ВХС.

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.

Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. 
<div class="accordion" id="accordionExample">
  <div class="card">
    <div class="card-header" id="headingOne">
      <h2 class="mb-0">
        <button class="btn btn-link" 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">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
      </div>
    </div>
  </div>
  <div class="card">
    <div class="card-header" id="headingTwo">
      <h2 class="mb-0">
        <button class="btn btn-link 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">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
      </div>
    </div>
  </div>
  <div class="card">
    <div class="card-header" id="headingThree">
      <h2 class="mb-0">
        <button class="btn btn-link 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">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
      </div>
    </div>
  </div>
</div>

Приступачност

Обавезно додајте aria-expandedконтролни елемент. Овај атрибут експлицитно преноси тренутно стање склопивог елемента повезаног са контролом читачима екрана и сличним помоћним технологијама. Ако је склопиви елемент затворен по подразумеваној вредности, атрибут на контролном елементу треба да има вредност aria-expanded="false". Ако сте подесили да склопиви елемент буде подразумевано отворен помоћу showкласе, aria-expanded="true"уместо тога поставите на контроли. Додатак ће аутоматски укључити овај атрибут на контроли на основу тога да ли је склопиви елемент отворен или затворен (преко ЈаваСцрипт-а или зато што је корисник покренуо други контролни елемент који је такође везан за исти склопиви елемент). Ако ХТМЛ елемент контролног елемента није дугме (нпр. <a>или <div>), атрибутrole="button"треба додати елементу.

Ако ваш контролни елемент циља на један склопиви елемент – тј. data-targetатрибут показује на idселектор – требало би да додате aria-controlsатрибут контролном елементу, који садржи idелемент склопивог. Савремени читачи екрана и сличне помоћне технологије користе овај атрибут како би корисницима пружиле додатне пречице за навигацију директно до самог склопивог елемента.

Имајте на уму да Боотстрап-ова тренутна имплементација не покрива различите интеракције са тастатуром описане у ВАИ-АРИА Аутхоринг Працтицес 1.1 обрасцу хармонике – мораћете да их сами укључите у прилагођени ЈаваСцрипт.

Употреба

Додатак за колапс користи неколико класа да би се носио са тешким подизањем:

  • .collapseсакрива садржај
  • .collapse.showприказује садржај
  • .collapsingсе додаје када транзиција почне, а уклања се када се заврши

Ове класе се могу наћи у _transitions.scss.

Преко атрибута података

Само додајте data-toggle="collapse"и а data-targetелементу да бисте аутоматски доделили контролу над једним или више склопивих елемената. Атрибут data-targetприхвата ЦСС селектор за примену скупљања. Обавезно додајте класу collapseу склопиви елемент. Ако желите да се подразумевано отвори, додајте додатну класу show.

Да бисте додали управљање групама налик хармоници у склопиву област, додајте атрибут података data-parent="#selector". Погледајте демо да видите ово у акцији.

Преко ЈаваСцрипт-а

Омогућите ручно помоћу:

$('.collapse').collapse()

Опције

Опције се могу пренети преко атрибута података или ЈаваСцрипт-а. За атрибуте података додајте име опције у data-, као у data-parent="".

Име Тип Уобичајено Опис
родитељ селектор | јКуери објекат | ДОМ елемент лажно Ако је наведен родитељ, онда ће сви склопиви елементи испод наведеног надређеног бити затворени када се прикаже ова склопива ставка. (слично традиционалном понашању хармонике - ово зависи од cardкласе). Атрибут мора бити постављен на циљну склопиву област.
искључи боолеан истинито Укључује склопиви елемент при позивању

Методе

Асинхроне методе и прелази

Све АПИ методе су асинхроне и покрећу транзицију . Они се враћају позиваоцу чим се транзиција започне, али пре него што се заврши . Поред тога, позив методе за прелазну компоненту биће занемарен .

Погледајте нашу ЈаваСцрипт документацију за више информација .

.collapse(options)

Активира ваш садржај као склопиви елемент. Прихвата опционе опције object.

$('#myCollapsible').collapse({
  toggle: false
})

.collapse('toggle')

Пребацује склопиви елемент на приказан или скривен. Враћа позиваоцу пре него што је склопиви елемент заправо приказан или сакривен (тј. пре него што се деси догађај shown.bs.collapseили ).hidden.bs.collapse

.collapse('show')

Приказује склопиви елемент. Враћа позиваоцу пре него што је склопиви елемент заиста приказан (тј. пре него што се shown.bs.collapseдогађај деси).

.collapse('hide')

Сакрива склопиви елемент. Враћа позиваоцу пре него што је склопиви елемент заиста сакривен (тј. пре него што се hidden.bs.collapseдогађај деси).

.collapse('dispose')

Уништава колапс елемента.

Догађаји

Боотстрап-ова класа колапса излаже неколико догађаја за спајање на функционалност колапса.

Тип догађаја Опис
схов.бс.цоллапсе Овај догађај се покреће одмах када showсе позове метод инстанце.
приказано.бс.цоллапсе Овај догађај се покреће када се кориснику учини видљивим елемент сажимања (сачекаће да се ЦСС транзиције доврше).
хиде.бс.цоллапсе Овај догађај се покреће одмах када се hideметода позове.
хидден.бс.цоллапсе Овај догађај се покреће када је елемент сажимања сакривен од корисника (сачекаће да се ЦСС транзиције доврше). 
$('#myCollapsible').on('hidden.bs.collapse', function () {
  // do something…
})