Bootstrap Plugin Collapse (Colapso)

El plugin Collapse (Colapso) permite plegar fácilmente las áreas de la página. Ya sea que lo use para crear navegación plegable o paneles de contenido, ofrece muchas opciones de contenido.

Si desea hacer referencia a las funciones de este plugin por separado, necesita incluircollapse.js. Además, también necesita incluir en su versión de Bootstrap elplugin Transition (Transición). O bien, como se menciona en el capítuloDescripción general de los plugins de Bootstrap, puede hacer referencia abootstrap.jso la versión comprimida debootstrap.min.js。

Puede usar el plugin Collapse (Colapso):

  • Crear grupos plegables o paneles de acordeón (accordion), como se muestra a continuación:

    Ejemplo

    <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">Haga clic en mí para expandir, haga clic de nuevo en mí para plegar. Parte 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">Haga clic en mí para expandir, haga clic de nuevo en mí para plegar. Parte 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">Haga clic en mí para expandir, haga clic de nuevo en mí para plegar. Parte 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>

    Pruébelo »

    El resultado se muestra a continuación:

    折叠面板
    1. data-toggle="collapse"Agregue al enlace del componente que desea expandir o plegar.
    2. hrefodata-targetEl atributo se agrega al componente principal, cuyo valor es el del componente hijo.id。
    3. data-parentEl atributo agrega el id del panel de acordeón (accordion) al enlace del componente que se va a expandir o plegar.
  • Crear un componente plegable simple (collapsible) sin marcas de acordeón (accordion), como se muestra a continuación:

    Ejemplo

    <button type="button" class="btn btn-primary" data-toggle="collapse" data-target="#demo">Componente plegable simple</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>

    Pruébelo »

    El resultado se muestra a continuación:

    简单的可折叠组件

    Como puede ver en el ejemplo, hemos creado un componente plegable; a diferencia del panel de acordeón (accordion), no agregamos el atributo.data-parent。

Uso

La siguiente tabla enumera las clases (class) que utiliza el plugin Collapse (Colapso) para manejar la expansión y contracción:

ClassDescripciónEjemplo
.collapseOculta el contenido.Pruébelo
.collapse.inMuestra el contenido.Pruébelo
.collapsingSe agrega cuando comienza el efecto de transición y se elimina cuando finaliza. 

Puede usar el plugin Collapse (Colapso) de las siguientes dos maneras:

  • Mediante atributos data: Agregue al elementodata-toggle="collapse"ydata-target, se asigna automáticamente el control del elemento plegable.data-targetEl atributo acepta un selector CSS y le aplica el efecto de plegado. Asegúrese de agregar la clase.collapse. Si desea que esté abierto de forma predeterminada, agregue la clase adicional.in。

    Para agregar una gestión de grupo similar a un acordeón a los controles plegables, agregue el atributo datadata-parent="#selector"。

  • Mediante JavaScript: Puede activar el método collapse a través de JavaScript, como se muestra a continuación:
    $('.collapse').collapse()
    

Opciones

Hay algunas opciones que se pasan a través de atributos data o JavaScript. La siguiente tabla enumera estas opciones:

Nombre de la opciónTipo/Valor predeterminadoNombre del atributo dataDescripción
parentselector
Valor predeterminado: false
data-parentSi se proporciona un selector, cuando se muestre el elemento plegable, todos los elementos plegables bajo el elemento principal especificado se cerrarán. Esto es similar al comportamiento del acordeón (accordion) tradicional, que depende de la clase accordion-group.
toggleboolean
Valor predeterminado: true
data-toggleAlterna el elemento plegable al invocarlo.

Métodos

A continuación se muestran algunos métodos útiles del plugin Collapse (Colapso):

MétodoDescripciónEjemplo
Options: .collapse(options)Activa el contenido como elemento plegable. Acepta un objeto options opcional.
$('#identifier').collapse({
    toggle: false
})
Toggle: .collapse('toggle')Alterna mostrar/ocultar el elemento plegable.
$('#identifier').collapse('toggle')
Show: .collapse('show')Muestra el elemento plegable.
$('#identifier').collapse('show')
Hide: .collapse('hide')Oculta el elemento plegable.
$('#identifier').collapse('hide')

Ejemplo

El siguiente ejemplo demuestra el uso de los métodos:

Ejemplo

<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">Haga clic en mí para expandir, haga clic de nuevo en mí para plegar. Parte 1 -- método 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">Haga clic en mí para expandir, haga clic de nuevo en mí para plegar. Parte 2 -- método 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">Haga clic en mí para expandir, haga clic de nuevo en mí para plegar. Parte 3 -- método 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">Haga clic en mí para expandir, haga clic de nuevo en mí para plegar. Parte 4 -- método 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>

Pruébelo »

El resultado se muestra a continuación:

折叠(Collapse)插件方法

Eventos

La siguiente tabla enumera los eventos que se utilizan en el plugin Collapse (Colapso). Estos eventos se pueden usar como ganchos (hooks) en funciones.

EventoDescripciónEjemplo
show.bs.collapseEste evento se activa después de llamar al método show.
$('#identifier').on('show.bs.collapse', function () {
    // 执行一些动作...
})
shown.bs.collapseEste evento se activa cuando el elemento plegable es visible para el usuario (esperará a que se complete la transición CSS).
$('#identifier').on('shown.bs.collapse', function () {
    // 执行一些动作...
})
hide.bs.collapseEste evento se activa inmediatamente cuando se llama al método de instancia hide.
$('#identifier').on('hide.bs.collapse', function () {
    // 执行一些动作...
})
hidden.bs.collapseEste evento se activa cuando el elemento plegable está oculto para el usuario (esperará a que se complete la transición CSS).
$('#identifier').on('hidden.bs.collapse', function () {
    // 执行一些动作...
})

Ejemplo

El siguiente ejemplo demuestra el uso de los eventos:

Ejemplo

<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">Haga clic en mí para expandir, haga clic de nuevo en mí para plegar. -- evento 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('Oye, cuando expanda se mostrará esta advertencia.');}) });
</script>

Pruébelo »

El resultado se muestra a continuación:

折叠(Collapse)插件事件
Otras extensiones