Колапс
Вклучете ја видливоста на содржината низ вашиот проект со неколку класи и нашите додатоци за JavaScript.
Како работи
Приклучокот за колапс JavaScript се користи за прикажување и криење на содржината. Копчињата или сидрата се користат како активирања кои се мапирани на одредени елементи што ги менувате. Со собирање елемент ќе се анимира heightод неговата моментална вредност во 0. Со оглед на тоа како CSS се справува со анимации, не можете да користите paddingна .collapseелемент. Наместо тоа, користете ја класата како независен елемент за завиткување.
Ефектот на анимација на оваа компонента зависи од prefers-reduced-motionмедиумското барање. Погледнете го делот за намалено движење од нашата документација за пристапност .
Пример
Кликнете на копчињата подолу за да прикажете и скриете друг елемент преку промени во класата:
.collapseја крие содржината.collapsingсе применува за време на транзициите.collapse.showпокажува содржина
Можете да користите врска со hrefатрибутот или копче со data-targetатрибутот. Во двата случаи, 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">
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>Повеќе цели
A <button>или <a>може да прикаже и скрие повеќе елементи со упатување на нив со избирач JQuery во неговиот 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">
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како обвивка.
<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"наместо тоа, поставете ја контролата. Приклучокот автоматски ќе го префрли овој атрибут на контролата врз основа на тоа дали елементот што се склопува е отворен или затворен (преку JavaScript или затоа што корисникот активирал друг контролен елемент, исто така поврзан со истиот склоплив елемент). Ако HTML елементот на контролниот елемент не е копче (на пример, an <a>или <div>), атрибутотrole="button"треба да се додаде на елементот.
Ако вашиот контролен елемент цели на еден склоплив елемент - т.е. data-targetатрибутот покажува на idизбирачот - треба да го додадете aria-controlsатрибутот на контролниот елемент, кој го содржи елементот idшто се склопува. Современите читачи на екран и слични помошни технологии го користат овој атрибут за да им обезбедат на корисниците дополнителни кратенки за директно навигација до самиот елемент што се склопува.
Имајте предвид дека тековната имплементација на Bootstrap не ги покрива различните интеракции на тастатурата опишани во шаблонот за хармоника WAI-ARIA авторски практики 1.1 - ќе треба сами да ги вклучите со приспособен JavaScript.
Употреба
Приклучокот за колапс користи неколку класи за да се справи со кревање тешки предмети:
.collapseја крие содржината.collapse.showја покажува содржината.collapsingсе додава кога ќе започне транзицијата и се отстранува кога ќе заврши
Овие часови може да се најдат во _transitions.scss.
Преку атрибути на податоци
Само додадете data-toggle="collapse"и a data-targetна елементот за автоматски да доделите контрола на еден или повеќе елементи што се склопуваат. Атрибутот data-targetприфаќа CSS избирач за да се примени колапсот. Не заборавајте да ја додадете класата collapseво склопувачкиот елемент. Ако сакате стандардно да се отвори, додадете ја дополнителната класа show.
За да додадете управување со група како хармоника во склоплива област, додајте го атрибутот податоци data-parent="#selector". Погледнете го демото за да го видите ова во акција.
Преку JavaScript
Овозможи рачно со:
$('.collapse').collapse()Опции
Опциите може да се пренесат преку атрибути на податоци или JavaScript. За атрибути на податоци, додајте го името на опцијата на data-, како во data-parent="".
| Име | Тип | Стандардно | Опис |
|---|---|---|---|
| родител | селектор | jQuery објект | DOM елемент | лажни | Ако е обезбеден родител, тогаш сите елементи што се склопуваат под наведениот родител ќе бидат затворени кога ќе се прикаже оваа ставка што може да се склопува. (слично на традиционалното однесување на хармоника - ова зависи од cardкласата). Атрибутот треба да се постави на целната склоплива област. |
| префрли | булови | вистина | Го исклучува склопувачкиот елемент при повикувањето |
Методи
Асинхрони методи и транзиции
Сите API методи се асинхрони и започнуваат транзиција . Тие се враќаат кај повикувачот штом ќе започне транзицијата, но пред да заврши . Дополнително, повик на метод на компонента во транзиција ќе се игнорира .
Погледнете ја нашата JavaScript документација за повеќе информации .
.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')
Уништува колапс на елемент.
Настани
Класата за колапс на Bootstrap изложува неколку настани за приклучување во функционалноста за колапс.
| Тип на настан | Опис |
|---|---|
| прикажи.бс.колапс | Овој настан се вклучува веднаш кога showќе се повика методот на пример. |
| прикажани.бс.колапс | Овој настан се активира кога елементот за колапс е видлив за корисникот (ќе чека да се завршат транзициите на CSS). |
| скриј.бс.сруши | Овој настан се активира веднаш кога hideметодот е повикан. |
| скриен.бс.колапс | Овој настан се активира кога елементот за колапс е скриен од корисникот (ќе чека да се завршат транзициите на CSS). |
$('#myCollapsible').on('hidden.bs.collapse', function () {
// do something...
})