Haga que los componentes de Bootstrap cobren vida, ahora con 13 complementos jQuery personalizados.
Los complementos se pueden incluir individualmente (aunque algunos tienen dependencias requeridas) o todos a la vez. Tanto bootstrap.js como bootstrap.min.js contienen todos los complementos en un solo archivo.
Puede usar todos los complementos de Bootstrap únicamente a través de la API de marcado sin escribir una sola línea de JavaScript. Esta es la API de primera clase de Bootstrap y debe ser su primera consideración al usar un complemento.
Dicho esto, en algunas situaciones puede ser conveniente desactivar esta funcionalidad. Por lo tanto, también brindamos la posibilidad de deshabilitar la API de atributos de datos al desvincular todos los eventos en el cuerpo con espacio de nombres `'data-api'`. Esto se ve así:
- $ ( 'cuerpo' ). desactivado ( '.data-api' )
Alternativamente, para apuntar a un complemento específico, simplemente incluya el nombre del complemento como un espacio de nombres junto con el espacio de nombres de la API de datos de esta manera:
- $ ( 'cuerpo' ). desactivado ( '.alert.data-api' )
También creemos que debería poder usar todos los complementos de Bootstrap únicamente a través de la API de JavaScript. Todas las API públicas son métodos únicos que se pueden encadenar y devuelven la colección sobre la que se actúa.
- $ ( ".btn.peligro" ). botón ( "alternar" ). addClass ( "gordo" )
Todos los métodos deben aceptar un objeto de opciones opcionales, una cadena que apunta a un método en particular o nada (lo que inicia un complemento con el comportamiento predeterminado):
- $ ( "#miModal" ). modal () // inicializado con valores predeterminados
- $ ( "#miModal" ). modal ({ teclado : falso }) // inicializado sin teclado
- $ ( "#miModal" ). modal ( 'show' ) // inicializa e invoca show inmediatamente
Cada complemento también expone su constructor en bruto en una propiedad `Constructor`: $.fn.popover.Constructor
. Si desea obtener una instancia de complemento en particular, recupérela directamente de un elemento: $('[rel=popover]').data('popover')
.
A veces es necesario usar complementos de Bootstrap con otros marcos de interfaz de usuario. En estas circunstancias, ocasionalmente pueden ocurrir colisiones de espacios de nombres. Si esto sucede, puede llamar .noConflict
al complemento cuyo valor desea revertir.
- var botón de arranque = $ . fn _ botón _ noConflict () // devuelve $.fn.button al valor previamente asignado
- $ . fn _ bootstrapBtn = bootstrapButton // otorga a $().bootstrapBtn la funcionalidad de arranque
Bootstrap proporciona eventos personalizados para la mayoría de las acciones únicas de los complementos. Por lo general, estos vienen en forma de infinitivo y participio pasado, donde el infinitivo (p. ej. show
) se activa al comienzo de un evento y su forma de participio pasado (p. ej.) se activa al shown
completar una acción.
Todos los eventos de infinitivo proporcionan la funcionalidad preventDefault. Esto proporciona la capacidad de detener la ejecución de una acción antes de que comience.
- $ ( '#miModal' ). en ( 'mostrar' , función ( e ) {
- si (! datos ) devuelve e . preventDefault () // evita que se muestre modal
- })
Para efectos de transición simples, incluya bootstrap-transition.js una vez junto con los otros archivos JS. Si está utilizando bootstrap.js compilado (o minimizado) , no es necesario incluirlo, ya está allí.
Algunos ejemplos del complemento de transición:
Los modales son mensajes de diálogo simplificados, pero flexibles, con la funcionalidad mínima requerida y valores predeterminados inteligentes.
Un modal representado con encabezado, cuerpo y conjunto de acciones en el pie de página.
Un buen cuerpo…
- <div clase = "desvanecimiento de ocultación modal" >
- < clase div = "encabezado-modal" >
- < tipo de botón = "botón" clase = "cerrar" data-dismiss = "modal" aria-hidden = "true" > × </botón>
- <h3> Cabecera modal </h3>
- </div>
- <div clase = "cuerpo-modal" >
- <p> Un buen cuerpo... </p>
- </div>
- <div clase = "modal-pie de página" >
- <a href = "#" class = "btn" > Cerrar </a>
- <a href = "#" class = "btn btn-primary" > Guardar cambios </a>
- </div>
- </div>
Alterne un modal a través de JavaScript haciendo clic en el botón a continuación. Se deslizará hacia abajo y se desvanecerá desde la parte superior de la página.
- <!-- Botón para activar modal -->
- <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Iniciar demostración modal </a>
- <!-- Modales -->
- <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
- < clase div = "encabezado-modal" >
- < tipo de botón = "botón" clase = "cerrar" datos-descartar = "modal" aria-hidden = "verdadero" > × </botón>
- <h3 id = "myModalLabel" > Cabecera modal </h3>
- </div>
- <div clase = "cuerpo-modal" >
- <p> Un buen cuerpo... </p>
- </div>
- <div clase = "modal-pie de página" >
- <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Cerrar </button>
- <button class = "btn btn-primary" > Guardar cambios </button>
- </div>
- </div>
Activa un modal sin escribir JavaScript. Establézcalo data-toggle="modal"
en un elemento del controlador, como un botón, junto con data-target="#foo"
o href="#foo"
para apuntar a un modal específico para alternar.
- <button type = "button" data-toggle = "modal" data-target = "#myModal" > Iniciar modal </button>
Llame a un modal con id myModal
con una sola línea de JavaScript:
- $ ( '#miModal' ). modal ( opciones )
Las opciones se pueden pasar a través de atributos de datos o JavaScript. Para los atributos de datos, agregue el nombre de la opción a data-
, como en data-backdrop=""
.
Nombre | escribe | defecto | descripción |
---|---|---|---|
fondo | booleano | verdadero | Incluye un elemento de fondo modal. Alternativamente, especifique static un fondo que no cierre el modal al hacer clic. |
teclado | booleano | verdadero | Cierra el modal cuando se presiona la tecla escape |
mostrar | booleano | verdadero | Muestra el modal cuando se inicializa. |
remoto | sendero | falso | Si se proporciona una URL remota, el contenido se cargará mediante el
|
Activa tu contenido como modal. Acepta opciones opcionales object
.
- $ ( '#miModal' ). modales ({
- teclado : falso
- })
Cambia manualmente un modal.
- $ ( '#miModal' ). modal ( 'alternar' )
Abre manualmente un modal.
- $ ( '#miModal' ). modal ( 'mostrar' )
Oculta manualmente un modal.
- $ ( '#miModal' ). modal ( 'ocultar' )
La clase modal de Bootstrap expone algunos eventos para conectarse a la funcionalidad modal.
Evento | Descripción |
---|---|
mostrar | Este evento se activa inmediatamente cuando show se llama al método de instancia. |
mostrado | Este evento se activa cuando el modal se ha hecho visible para el usuario (esperará a que se completen las transiciones css). |
ocultar | Este evento se activa inmediatamente cuando hide se llama al método de instancia. |
oculto | Este evento se activa cuando el modal ha terminado de ocultarse para el usuario (esperará a que se completen las transiciones css). |
- $ ( '#miModal' ). en ( 'oculto' , función () {
- // hacer algo…
- })
Agregue menús desplegables a casi cualquier cosa con este complemento simple, incluida la barra de navegación, las pestañas y las píldoras.
Agregue data-toggle="dropdown"
a un enlace o botón para alternar un menú desplegable.
- < clase div = "desplegable" >
- <a class = "dropdown-toggle" data-toggle = "dropdown" href = "#" > Desencadenador desplegable </a>
- < clase ul = "menú desplegable" rol = "menú" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Para mantener intactas las URL, use el data-target
atributo en lugar de href="#"
.
- < clase div = "desplegable" >
- <a class = "dropdown-toggle" id = "dLabel" role = "button" data-toggle = "dropdown" data-target = "#" href = "/page.html" >
- Desplegable
- <b clase = "intercalación" ></b>
- </a>
- < clase ul = "menú desplegable" rol = "menú" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Llame a los menús desplegables a través de JavaScript:
- $ ( '.dropdown-toggle' ). menú desplegable ()
Ninguna
Una API programática para alternar menús para una barra de navegación determinada o navegación con pestañas.
El complemento ScrollSpy es para actualizar automáticamente los objetivos de navegación en función de la posición de desplazamiento. Desplácese por el área debajo de la barra de navegación y observe cómo cambia la clase activa. Los subelementos desplegables también se resaltarán.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi antes de que se agotaran qui. Derechos de bicicleta de la granja a la mesa de Tumblr, lo que sea. Cárdigan anim keffiyeh carles. Cabina de fotos de velit seitan mcsweeney 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui probablemente no hayas oído hablar de ellos et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tatuado accusamus, cred irony biodiesel keffiyeh artesano ullamco consequat.
Veniam marfa bigote monopatín, adipisicing fugiat velit horca barba. Freegan barba aliqua cupidatat mcsweeney's vero. Cupidatat cuatro loko nisi, ea helvetica nulla carles. Camión de comida de suéter cosby tatuado, vinilo quis non freegan de mcsweeney. Lo-fi wes anderson +1 sastrería. Carles ejercicio no estético quis gentrify. Brooklyn adipisicing cerveza artesanal vice keytar deserunt.
Occaecat commodo aliqua delectus. Fap craft beer deserunt monopatín ea. Lomo bicicleta derechos adipisicing banh mi, velit ea sunt siguiente nivel locavore café de origen único en magna veniam. Vinilo de identificación de alta vida, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY bolso de mensajero mínimo. Cred ex in, sostenible delectus consectetur riñonera iphone.
In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
Keytar twee blog, bolsa de mensajero culpa marfa lo que sea camión de comida delectus. Sapiente sintetizador id asunción. Locavore sed helvetica cliché ironía, thundercats probablemente no hayas oído hablar de ellos consequat hoodie sin gluten lo-fi fap aliquip. Labore elit placeat antes de que se agotaran, terry richardson proident brunch nesciunt quis cosby sweater pariatur keffiyeh ut helvetica craft. Cardigan cerveza artesana seitán readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats.
Para agregar fácilmente el comportamiento de scrollspy a la navegación de la barra superior, simplemente agregue data-spy="scroll"
el elemento que desea espiar (por lo general, este sería el cuerpo) y data-target=".navbar"
seleccione qué navegación usar. Querrás usar scrollspy con un .nav
componente.
- <body data-spy = "scroll" data-target = ".navbar" > ... </body>
Llame al scrollspy a través de JavaScript:
- $ ( '#barra de navegación' ). scrollspy ()
<a href="#home">home</a>
debe corresponder a algo en el dom como
<div id="home"></div>
.
Cuando use scrollspy junto con la adición o eliminación de elementos del DOM, deberá llamar al método de actualización de la siguiente manera:
- $ ( '[data-spy="scroll"]' ). cada ( función () {
- var $espía = $ ( esto ). scrollspy ( 'actualizar' )
- });
Las opciones se pueden pasar a través de atributos de datos o JavaScript. Para los atributos de datos, agregue el nombre de la opción a data-
, como en data-offset=""
.
Nombre | escribe | defecto | descripción |
---|---|---|---|
compensar | número | 10 | Píxeles para compensar desde la parte superior al calcular la posición de desplazamiento. |
Evento | Descripción |
---|---|
activar | Este evento se activa cada vez que el scrollspy activa un nuevo elemento. |
Agregue una funcionalidad de pestaña dinámica y rápida para pasar a través de paneles de contenido local, incluso a través de menús desplegables.
Denim crudo, probablemente no hayas oído hablar de los shorts de jean Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Bigote cliché temporal, williamsburg carles vegan helvetica. Reprehenderit carnicero retro keffiyeh sintetizador atrapasueños. Cosby sweater eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan ropa americana, carnicero voluptate nisi qui.
Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.
Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
Habilite las pestañas que se pueden tabular a través de JavaScript (cada pestaña debe activarse individualmente):
- $ ( '#myTab a' ). hacer clic ( función ( e ) {
- mi . prevenirPredeterminado ();
- $ ( esto ). tabulador ( 'mostrar' );
- })
Puede activar pestañas individuales de varias maneras:
- $ ( '#myTab a[href="#perfil"]' ). tabulador ( 'mostrar' ); // Seleccionar pestaña por nombre
- $ ( '#myTab a:first' ). tabulador ( 'mostrar' ); // Selecciona la primera pestaña
- $ ( '#myTab a: last' ). tabulador ( 'mostrar' ); //Seleccionar última pestaña
- $ ( '#miTab li:eq(2) a' ). tabulador ( 'mostrar' ); // Seleccione la tercera pestaña (0-indexado)
Puede activar una pestaña o una píldora de navegación sin escribir JavaScript simplemente especificando data-toggle="tab"
o data-toggle="pill"
en un elemento. Agregar las clases nav
y a la pestaña aplicará el estilo de la pestaña Bootstrap.nav-tabs
ul
- <ul class = "nav nav-tabs" >
- <li><a href = "#home" data-toggle = "tab" > Inicio </a></li>
- <li><a href = "#profile" data-toggle = "tab" > Perfil </a></li>
- <li><a href = "#mensajes" data-toggle = "tab" > Mensajes </a></li>
- <li><a href = "#settings" data-toggle = "tab" > Configuración </a></li>
- </ul>
Activa un elemento de pestaña y un contenedor de contenido. La pestaña debe tener un data-target
o un href
nodo contenedor en el DOM.
- <ul class = "nav nav-tabs" id = "myTab" >
- <li class = "active" ><a href = "#home" > Inicio </a></li>
- <li><a href = "#perfil" > Perfil </a></li>
- <li><a href = "#mensajes" > Mensajes </a></li>
- <li><a href = "#settings" > Configuración </a></li>
- </ul>
- < clase div = "contenido de la pestaña" >
- <div class = "tab-pane active" id = "home" > ... </div>
- <div class = "tab-pane" id = "perfil" > ... </div>
- <div clase = "panel de pestañas" id = "mensajes" > ... </div>
- <div clase = "panel de pestañas" id = "configuración" > ... </div>
- </div>
- <script>
- $ ( función () {
- $ ( '#myTab a: last' ). tabulador ( 'mostrar' );
- })
- </script>
Evento | Descripción |
---|---|
mostrar | Este evento se activa al mostrar la pestaña, pero antes de que se muestre la nueva pestaña. Use event.target y event.relatedTarget para apuntar a la pestaña activa y la pestaña activa anterior (si está disponible) respectivamente. |
mostrado | Este evento se activa en la presentación de pestañas después de que se haya mostrado una pestaña. Use event.target y event.relatedTarget para apuntar a la pestaña activa y la pestaña activa anterior (si está disponible) respectivamente. |
- $ ( 'a[cambio de datos="tab"]' ). en ( 'mostrado' , función ( e ) {
- mi . objetivo // pestaña activada
- mi . objetivo relacionado // pestaña anterior
- })
Inspirado en el excelente complemento jQuery.tipsy escrito por Jason Frame; La información sobre herramientas es una versión actualizada, que no se basa en imágenes, utiliza CSS3 para animaciones y atributos de datos para el almacenamiento local de títulos.
Por razones de rendimiento, la información sobre herramientas y las API de datos emergentes están habilitadas, lo que significa que debe inicializarlas usted mismo .
Pase el cursor sobre los enlaces a continuación para ver información sobre herramientas:
Pantalones ajustados al siguiente nivel keffiyeh , probablemente no hayas oído hablar de ellos. Bolso bandolera vegano tipo fotomatón con barba en denim crudo stumptown. El seitán de la granja a la mesa, la ropa americana de 8 bits de quinoa sostenible fixie de mcsweeney tiene un cambray de vinilo terry richardson. Beard stumptown, cárdigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, cuatro loko mcsweeney's cleanse vegan chambray. Un artesano realmente irónico sea cual sea el keytar , scenester de la granja a la mesa .
Cuando use información sobre herramientas y ventanas emergentes con los grupos de entrada de Bootstrap, deberá configurar la container
opción (documentada a continuación) para evitar efectos secundarios no deseados.
Active la información sobre herramientas a través de JavaScript:
- $ ( '#ejemplo' ). información sobre herramientas ( opciones )
Las opciones se pueden pasar a través de atributos de datos o JavaScript. Para los atributos de datos, agregue el nombre de la opción a data-
, como en data-animation=""
.
Nombre | escribe | defecto | descripción |
---|---|---|---|
animación | booleano | verdadero | aplicar una transición de fundido css a la información sobre herramientas |
html | booleano | falso | Inserte html en la información sobre herramientas. Si es falso, se text usará el método de jquery para insertar contenido en el dom. Use texto si le preocupan los ataques XSS. |
colocación | cadena | función | 'parte superior' | cómo colocar la información sobre herramientas - parte superior | abajo | izquierda | Correcto |
selector | cuerda | falso | Si se proporciona un selector, los objetos de información sobre herramientas se delegarán a los objetivos especificados. |
título | cadena | función | '' | valor de título predeterminado si la etiqueta `título` no está presente |
generar | cuerda | 'enfoque flotante' | cómo se activa la información sobre herramientas: haga clic en | flotar | enfoque | manual. Tenga en cuenta que el caso pasa disparadores múltiples, separados por espacios, tipos de disparadores. |
demora | número | objeto | 0 | retraso en mostrar y ocultar la información sobre herramientas (ms) - no se aplica al tipo de disparo manual Si se proporciona un número, la demora se aplica tanto para ocultar/mostrar La estructura del objeto es: |
envase | cadena | falso | falso | Agrega la información sobre herramientas a un elemento específico |
- <a href = "#" data-toggle = "tooltip" title = "primera información sobre herramientas" > pasa el cursor sobre mí </a>
Adjunta un controlador de información sobre herramientas a una colección de elementos.
Revela la información sobre herramientas de un elemento.
- $ ( '#elemento' ). información sobre herramientas ( 'mostrar' )
Oculta la información sobre herramientas de un elemento.
- $ ( '#elemento' ). información sobre herramientas ( 'ocultar' )
Alterna la información sobre herramientas de un elemento.
- $ ( '#elemento' ). información sobre herramientas ( 'alternar' )
Oculta y destruye la información sobre herramientas de un elemento.
- $ ( '#elemento' ). información sobre herramientas ( 'destruir' )
Agregue pequeñas superposiciones de contenido, como las del iPad, a cualquier elemento para albergar información secundaria. Pase el cursor sobre el botón para activar la ventana emergente. Requiere Tooltip para ser incluido.
Hay cuatro opciones disponibles: alineación superior, derecha, inferior e izquierda.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
No se generan marcas que se muestran como elementos emergentes a partir de JavaScript y contenido dentro de un data
atributo.
Habilitar ventanas emergentes a través de JavaScript:
- $ ( '#ejemplo' ). ventana emergente ( opciones )
Las opciones se pueden pasar a través de atributos de datos o JavaScript. Para los atributos de datos, agregue el nombre de la opción a data-
, como en data-animation=""
.
Nombre | escribe | defecto | descripción |
---|---|---|---|
animación | booleano | verdadero | aplicar una transición de fundido css a la información sobre herramientas |
html | booleano | falso | Inserte html en la ventana emergente. Si es falso, se text usará el método de jquery para insertar contenido en el dom. Use texto si le preocupan los ataques XSS. |
colocación | cadena | función | 'Correcto' | cómo colocar el popover - parte superior | abajo | izquierda | Correcto |
selector | cuerda | falso | si se proporciona un selector, los objetos de información sobre herramientas se delegarán a los objetivos especificados |
generar | cuerda | 'hacer clic' | cómo se activa el popover - haga clic en | flotar | enfoque | manual |
título | cadena | función | '' | valor de título predeterminado si el atributo `título` no está presente |
contenido | cadena | función | '' | valor de contenido predeterminado si el atributo `data-content` no está presente |
demora | número | objeto | 0 | retraso en mostrar y ocultar el popover (ms) - no se aplica al tipo de activación manual Si se proporciona un número, la demora se aplica tanto para ocultar/mostrar La estructura del objeto es: |
envase | cadena | falso | falso | Agrega el popover a un elemento específico |
Por motivos de rendimiento, las API de información sobre herramientas y ventana emergente están habilitadas. Si desea utilizarlas, simplemente especifique una opción de selección.
Inicializa popovers para una colección de elementos.
Revela una ventana emergente de elementos.
- $ ( '#elemento' ). popover ( 'mostrar' )
Oculta una ventana emergente de elementos.
- $ ( '#elemento' ). popover ( 'ocultar' )
Alterna una ventana emergente de elementos.
- $ ( '#elemento' ). popover ( 'alternar' )
Oculta y destruye el popover de un elemento.
- $ ( '#elemento' ). popover ( 'destruir' )
Agregue la funcionalidad de descartar a todos los mensajes de alerta con este complemento.
Cambia esto y aquello e inténtalo de nuevo. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Habilite el rechazo de una alerta a través de JavaScript:
- $ ( ".alerta" ). alerta ()
Simplemente agréguelo data-dismiss="alert"
a su botón de cierre para dar automáticamente una funcionalidad de cierre de alerta.
- <a class = "close" data-dismiss = "alert" href = "#" > × </a>
Envuelve todas las alertas con funcionalidad de cierre. Para que sus alertas se activen cuando estén cerradas, asegúrese de que ya se les haya aplicado la clase .fade
y ..in
Cierra una alerta.
- $ ( ".alerta" ). alerta ( 'cerrar' )
La clase de alerta de Bootstrap expone algunos eventos para conectarse a la funcionalidad de alerta.
Evento | Descripción |
---|---|
cerca | Este evento se activa inmediatamente cuando close se llama al método de instancia. |
cerrado | Este evento se activa cuando se ha cerrado la alerta (esperará a que se completen las transiciones css). |
- $ ( '#mi-alerta' ). enlazar ( 'cerrado' , función () {
- // hacer algo…
- })
Obtenga estilos básicos y soporte flexible para componentes plegables como acordeones y navegación.
* Requiere que se incluya el complemento Transiciones.
Usando el complemento de colapso, construimos un widget de estilo acordeón simple:
- <div class = "acordeón" id = "acordeón2" >
- <div clase = "grupo-acordeón" >
- <div clase = "título-acordeón" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
- Artículo de grupo plegable n.º 1
- </a>
- </div>
- <div id = "collapseOne" class = "cuerpo de acordeón colapsar en" >
- <div clase = "acordeón-interior" >
- Anim pariatur cliché...
- </div>
- </div>
- </div>
- <div clase = "grupo-acordeón" >
- <div clase = "título-acordeón" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
- Artículo de grupo plegable n.º 2
- </a>
- </div>
- <div id = "collapseTwo" class = "colapso del cuerpo del acordeón" >
- <div clase = "acordeón-interior" >
- Anim pariatur cliché...
- </div>
- </div>
- </div>
- </div>
- ...
También puede usar el complemento sin el marcado de acordeón. Haga que un botón alterne la expansión y el colapso de otro elemento.
- < tipo de botón = "botón" clase = "btn btn-peligro" alternar datos = "contraer" objetivo de datos = "#demo" >
- plegable simple
- </botón>
- <div id = "demo" class = "contraer en" > … </div>
Simplemente agregue data-toggle="collapse"
y un data-target
elemento para asignar automáticamente el control de un elemento contraíble. El data-target
atributo acepta un selector css para aplicar el colapso. Asegúrese de agregar la clase collapse
al elemento contraíble. Si desea que se abra de forma predeterminada, agregue la clase adicional in
.
Para agregar una administración de grupos similar a un acordeón a un control contraíble, agregue el atributo de datos data-parent="#selector"
. Consulte la demostración para ver esto en acción.
Habilitar manualmente con:
- $ ( ".contraer" ). colapso ()
Las opciones se pueden pasar a través de atributos de datos o JavaScript. Para los atributos de datos, agregue el nombre de la opción a data-
, como en data-parent=""
.
Nombre | escribe | defecto | descripción |
---|---|---|---|
padre | selector | falso | Si se selecciona, todos los elementos contraíbles bajo el padre especificado se cerrarán cuando se muestre este elemento contraíble. (similar al comportamiento tradicional del acordeón) |
palanca | booleano | verdadero | Alterna el elemento contraíble en la invocación |
Activa tu contenido como un elemento colapsable. Acepta opciones opcionales object
.
- $ ( '#myCollapsible' ). colapsar ({
- alternar : falso
- })
Cambia un elemento colapsable a mostrado u oculto.
Muestra un elemento plegable.
Oculta un elemento contraíble.
La clase de colapso de Bootstrap expone algunos eventos para conectarse a la funcionalidad de colapso.
Evento | Descripción |
---|---|
mostrar | Este evento se activa inmediatamente cuando show se llama al método de instancia. |
mostrado | Este evento se activa cuando un elemento de colapso se ha hecho visible para el usuario (esperará a que se completen las transiciones css). |
ocultar | Este evento se activa inmediatamente cuando hide se llama al método. |
oculto | Este evento se activa cuando un elemento de colapso se ha ocultado al usuario (esperará a que se completen las transiciones css). |
- $ ( '#myCollapsible' ). en ( 'oculto' , función () {
- // hacer algo…
- })
La presentación de diapositivas a continuación muestra un complemento genérico y un componente para recorrer elementos como un carrusel.
- <div id = "myCarousel" class = "diapositiva del carrusel" >
- < clase ol = "indicadores-carrusel" >
- <li data-target = "#myCarousel" data-slide-to = "0" class = "active" ></li>
- <li data-target = "#myCarousel" data-slide-to = "1" ></li>
- <li data-target = "#myCarousel" data-slide-to = "2" ></li>
- </ol>
- <!-- Elementos del carrusel -->
- <div clase = "carrusel-interior" >
- <div clase = "elemento activo" > … </div>
- <div clase = "elemento" > … </div>
- <div clase = "elemento" > … </div>
- </div>
- <!-- Navegación carrusel -->
- <a class = "carrusel-control izquierda" href = "#myCarousel" data-slide = "prev" > ‹ </a>
- <a class = "carrusel-control derecho" href = "#myCarousel" data-slide = "siguiente" > › </a>
- </div>
Use data attributes to easily control the position of the carousel. data-slide
accepts the keywords prev
or next
, which alters the slide position relative to it's current position. Alternatively, use data-slide-to
to pass a raw slide index to the carousel data-slide-to="2"
, which jump's the slide position to a particular index beginning with 0
.
Call carousel manually with:
- $('.carousel').carousel()
Options can be passed via data attributes or JavaScriptz. For data attributes, append the option name to data-
, as in data-interval=""
.
Name | type | default | description |
---|---|---|---|
interval | number | 5000 | The amount of time to delay between automatically cycling an item. If false, carousel will not automatically cycle. |
pause | string | "hover" | Pauses the cycling of the carousel on mouseenter and resumes the cycling of the carousel on mouseleave. |
Initializes the carousel with an optional options object
and starts cycling through items.
- $('.carousel').carousel({
- interval: 2000
- })
Cycles through the carousel items from left to right.
Stops the carousel from cycling through items.
Cycles the carousel to a particular frame (0 based, similar to an array).
Cycles to the previous item.
Cycles to the next item.
Bootstrap's carousel class exposes two events for hooking into carousel functionality.
Event | Description |
---|---|
slide | This event fires immediately when the slide instance method is invoked. |
slid | This event is fired when the carousel has completed its slide transition. |
A basic, easily extended plugin for quickly creating elegant typeaheads with any form text input.
- <input type="text" data-provide="typeahead">
You'll want to set autocomplete="off"
to prevent default browser menus from appearing over the Bootstrap typeahead dropdown.
Add data attributes to register an element with typeahead functionality as shown in the example above.
Call the typeahead manually with:
- $('.typeahead').typeahead()
Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-
, as in data-source=""
.
Name | type | default | description |
---|---|---|---|
source | array, function | [ ] | The data source to query against. May be an array of strings or a function. The function is passed two arguments, the query value in the input field and the process callback. The function may be used synchronously by returning the data source directly or asynchronously via the process callback's single argument. |
items | number | 8 | The max number of items to display in the dropdown. |
minLength | number | 1 | The minimum character length needed before triggering autocomplete suggestions |
matcher | function | case insensitive | The method used to determine if a query matches an item. Accepts a single argument, the item against which to test the query. Access the current query with this.query . Return a boolean true if query is a match. |
sorter | function | exact match, case sensitive, case insensitive |
Method used to sort autocomplete results. Accepts a single argument items and has the scope of the typeahead instance. Reference the current query with this.query . |
updater | function | returns selected item | The method used to return selected item. Accepts a single argument, the item and has the scope of the typeahead instance. |
highlighter | function | highlights all default matches | Method used to highlight autocomplete results. Accepts a single argument item and has the scope of the typeahead instance. Should return html. |
Initializes an input with a typeahead.
The subnavigation on the left is a live demo of the affix plugin.
To easily add affix behavior to any element, just add data-spy="affix"
to the element you want to spy on. Then use offsets to define when to toggle the pinning of an element on and off.
- <div data-spy="affix" data-offset-top="200">...</div>
affix
,
affix-top
, and
affix-bottom
. Remember to check for a potentially collapsed parent when the affix kicks in as it's removing content from the normal flow of the page.
Call the affix plugin via JavaScript:
- $('#navbar').affix()
Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-
, as in data-offset-top="200"
.
Name | type | default | description |
---|---|---|---|
offset | number | function | object | 10 | Píxeles para compensar desde la pantalla al calcular la posición de desplazamiento. Si se proporciona un solo número, la compensación se aplicará en las direcciones superior e izquierda. Para escuchar una sola dirección o múltiples compensaciones únicas, simplemente proporcione un objeto offset: { x: 10 } . Utilice una función cuando necesite proporcionar un desplazamiento de forma dinámica (útil para algunos diseños receptivos). |