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:
- data-toggle="collapse"Agregue al enlace del componente que desea expandir o plegar.
- hrefodata-targetEl atributo se agrega al componente principal, cuyo valor es el del componente hijo.id。
- 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:
| Class | Descripción | Ejemplo |
|---|---|---|
| .collapse | Oculta el contenido. | Pruébelo |
| .collapse.in | Muestra el contenido. | Pruébelo |
| .collapsing | Se 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ón | Tipo/Valor predeterminado | Nombre del atributo data | Descripción |
|---|---|---|---|
| parent | selector Valor predeterminado: false | data-parent | Si 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. |
| toggle | boolean Valor predeterminado: true | data-toggle | Alterna el elemento plegable al invocarlo. |
Métodos
A continuación se muestran algunos métodos útiles del plugin Collapse (Colapso):
| Método | Descripción | Ejemplo |
|---|---|---|
| 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
Pruébelo »
El resultado se muestra a continuación:
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.
| Evento | Descripción | Ejemplo |
|---|---|---|
| show.bs.collapse | Este evento se activa después de llamar al método show. |
$('#identifier').on('show.bs.collapse', function () {
// 执行一些动作...
})
|
| shown.bs.collapse | Este 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.collapse | Este evento se activa inmediatamente cuando se llama al método de instancia hide. |
$('#identifier').on('hide.bs.collapse', function () {
// 执行一些动作...
})
|
| hidden.bs.collapse | Este 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
Pruébelo »
El resultado se muestra a continuación: