Bootstrap Плагин Collapse
Плагин Collapse позволяет легко сворачивать области страницы. Используете ли вы его для создания сворачиваемой навигации или панелей содержимого, он предоставляет множество вариантов содержимого.
Если вы хотите отдельно подключить функциональность этого плагина, вам нужно подключитьcollapse.js. Также в вашей версии Bootstrap необходимо подключитьплагин Transition. Или, какОбзор плагинов Bootstrapупомянуто в главе, вы можете подключитьbootstrap.jsили сжатую версиюbootstrap.min.js。
- Создание сворачиваемых групп или аккордеонов, как показано ниже:
Пример
<div class="panel-group" id="accordion"> <div class="panel panel-default"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseOne">Нажмите на меня, чтобы развернуть, нажмите ещё раз, чтобы свернуть. Часть 1</a> </h4> </div> <div id="collapseOne" class="panel-collapse collapse in"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> <div class="panel panel-default"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseTwo">Нажмите на меня, чтобы развернуть, нажмите ещё раз, чтобы свернуть. Часть 2</a> </h4> </div> <div id="collapseTwo" class="panel-collapse collapse"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> <div class="panel panel-default"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseThree">Нажмите, чтобы развернуть, нажмите ещё раз, чтобы свернуть. Часть 3</a> </h4> </div> <div id="collapseThree" class="panel-collapse collapse"> <div class="panel-body"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div> </div> </div> </div>
Попробуйте »Результат показан ниже:
- data-toggle="collapse"Добавьте к ссылке компонента, который вы хотите развернуть или свернуть.
- hrefилиdata-targetАтрибут добавляется к родительскому компоненту, а его значением являетсяid дочернего компонента。
- data-parentАтрибут добавляет id аккордеона к ссылке компонента, который нужно развернуть или свернуть.
- Создайте простой сворачиваемый компонент без разметки аккордеона, как показано ниже:
Пример
<button type="button" class="btn btn-primary" data-toggle="collapse" data-target="#demo">Простой сворачиваемый компонент</button> <div id="demo" class="collapse in"> Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. </div>
Попробуйте »Результат показан ниже:
Как видно из примера, мы создали сворачиваемый компонент; в отличие от аккордеона, мы не добавили атрибутdata-parent。
Использование
В следующей таблице перечислены классы, которые плагин Collapse использует для выполнения основной работы:
| Класс | Описание | Пример |
|---|---|---|
| .collapse | Скрывает содержимое. | Попробуйте |
| .collapse.in | Показывает содержимое. | Попробуйте |
| .collapsing | Добавляется при начале перехода, удаляется при завершении перехода. |
Вы можете использовать плагин Collapse следующими двумя способами:
- Через атрибуты data: Добавьте к элементуdata-toggle="collapse"иdata-target, автоматически назначает управление сворачиваемым элементом.data-targetАтрибут принимает CSS-селектор и применит к нему эффект сворачивания. Убедитесь, что добавили класс.collapseк сворачиваемому элементу. Если вы хотите, чтобы он был открыт по умолчанию, добавьте дополнительный класс.in。
Чтобы добавить управление группой в стиле аккордеона к сворачиваемому элементу управления, добавьте атрибут datadata-parent="#selector"。
- Через JavaScript: Вы можете активировать метод collapse через JavaScript, как показано ниже:
$('.collapse').collapse()
Параметры
Некоторые параметры можно передавать через атрибуты data или JavaScript. В следующей таблице перечислены эти параметры:
| Название параметра | Тип/Значение по умолчанию | Имя атрибута данных | Описание |
|---|---|---|---|
| parent | selector По умолчанию: false | data-parent | Если указан селектор, то при отображении сворачиваемого элемента все остальные сворачиваемые элементы внутри указанного parent будут закрыты. Это похоже на поведение традиционного аккордеона — это зависит от класса accordion-group. |
| toggle | логическое значение По умолчанию: true | data-toggle | Переключает сворачиваемый элемент при вызове. |
Методы
Ниже приведены некоторые полезные методы плагина Collapse:
| Метод | Описание | Пример |
|---|---|---|
| Параметры: .collapse(options) | Активирует содержимое как сворачиваемый элемент. Принимает необязательный объект параметров. |
$('#identifier').collapse({
toggle: false
})
|
| Переключение: .collapse('toggle') | Переключение показа/скрытия для сворачиваемых элементов. |
$('#identifier').collapse('toggle')
|
| Показать: .collapse('show') | Показать сворачиваемые элементы. |
$('#identifier').collapse('show')
|
| Скрыть: .collapse('hide') | Скрыть сворачиваемые элементы. |
$('#identifier').collapse('hide')
|
Пример
Примеры ниже демонстрируют использование методов:
Пример
Попробуйте сами »
Результат показан ниже:
Events
В следующей таблице перечислены события, используемые в плагине Collapse. Эти события можно использовать в качестве хуков в функциях.
| Event | Описание | Пример |
|---|---|---|
| show.bs.collapse | Это событие возникает после вызова метода show. |
$('#identifier').on('show.bs.collapse', function () {
// 执行一些动作...
})
|
| shown.bs.collapse | Это событие генерируется, когда сворачиваемый элемент становится видимым для пользователя (оно будет ждать завершения CSS-перехода). |
$('#identifier').on('shown.bs.collapse', function () {
// 执行一些动作...
})
|
| hide.bs.collapse | Это событие генерируется сразу же при вызове метода экземпляра hide. |
$('#identifier').on('hide.bs.collapse', function () {
// 执行一些动作...
})
|
| hidden.bs.collapse | Это событие генерируется, когда сворачиваемый элемент скрывается от пользователя (оно будет ждать завершения CSS-перехода). |
$('#identifier').on('hidden.bs.collapse', function () {
// 执行一些动作...
})
|
Пример
Примеры ниже демонстрируют использование этих событий:
Пример
Попробуйте сами »
Результат показан ниже: