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>

    Попробуйте »

    Результат показан ниже:

    折叠面板
    1. data-toggle="collapse"Добавьте к ссылке компонента, который вы хотите развернуть или свернуть.
    2. hrefилиdata-targetАтрибут добавляется к родительскому компоненту, а его значением являетсяid дочернего компонента。
    3. 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. В следующей таблице перечислены эти параметры:

Название параметраТип/Значение по умолчаниюИмя атрибута данныхОписание
parentselector
По умолчанию: 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')

Пример

Примеры ниже демонстрируют использование методов:

Пример

<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 -- метод hide</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-success"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseTwo">Нажмите, чтобы развернуть, нажмите еще раз, чтобы свернуть. Часть 2 -- метод show</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-info"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseThree">Нажмите, чтобы развернуть, нажмите еще раз, чтобы свернуть. Часть 3 -- метод toggle</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 class="panel panel-warning"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseFour">Нажмите, чтобы развернуть, нажмите ещё раз, чтобы свернуть. Часть 4 -- метод options</a> </h4> </div> <div id="collapseFour" 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> <script>
$(function () { $('#collapseFour').collapse({ toggle: false })}); $(function () { $('#collapseTwo').collapse('show')}); $(function () { $('#collapseThree').collapse('toggle')}); $(function () { $('#collapseOne').collapse('hide')});
</script>

Попробуйте сами »

Результат показан ниже:

折叠(Collapse)插件方法

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 () {
    // 执行一些动作...
})

Пример

Примеры ниже демонстрируют использование этих событий:

Пример

<div class="panel-group" id="accordion"> <div class="panel panel-info"> <div class="panel-heading"> <h4 class="panel-title"> <a data-toggle="collapse" data-parent="#accordion" href="#collapseexample">Нажмите на меня, чтобы развернуть, нажмите снова, чтобы свернуть. -- событие shown</a> </h4> </div> <div id="collapseexample" 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> <script>
$(function () { $('#collapseexample').on('show.bs.collapse', function () { alert('Эй, это предупреждение будет показано, когда вы развернёте.');}) });
</script>

Попробуйте сами »

Результат показан ниже:

折叠(Collapse)插件事件
Другие расширения