JavaScript

Haga que los componentes de Bootstrap cobren vida, ahora con 13 complementos jQuery personalizados.

¡Aviso! Estos documentos son para v2.3.2, que ya no es oficialmente compatible. ¡Mira la última versión de Bootstrap!

Individual o compilado

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.

Atributos de datos

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í:

  1. $ ( '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:

  1. $ ( 'cuerpo' ). desactivado ( '.alert.data-api' )

API programática

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.

  1. $ ( ".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):

  1. $ ( "#miModal" ). modal () // inicializado con valores predeterminados
  2. $ ( "#miModal" ). modal ({ teclado : falso }) // inicializado sin teclado
  3. $ ( "#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').

No conflicto

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 .noConflictal complemento cuyo valor desea revertir.

  1. var botón de arranque = $ . fn _ botón _ noConflict () // devuelve $.fn.button al valor previamente asignado
  2. $ . fn _ bootstrapBtn = bootstrapButton // otorga a $().bootstrapBtn la funcionalidad de arranque

Eventos

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 showncompletar 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.

  1. $ ( '#miModal' ). en ( 'mostrar' , función ( e ) {
  2. si (! datos ) devuelve e . preventDefault () // evita que se muestre modal
  3. })

Acerca de las transiciones

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í.

casos de uso

Algunos ejemplos del complemento de transición:

  • Deslizamiento o desvanecimiento en modales
  • Pestañas que se desvanecen
  • Alertas que se desvanecen
  • Paneles deslizantes de carrusel

Ejemplos

Los modales son mensajes de diálogo simplificados, pero flexibles, con la funcionalidad mínima requerida y valores predeterminados inteligentes.

Ejemplo estático

Un modal representado con encabezado, cuerpo y conjunto de acciones en el pie de página.

  1. <div clase = "desvanecimiento de ocultación modal" >
  2. < clase div = "encabezado-modal" >
  3. < tipo de botón = "botón" clase = "cerrar" data-dismiss = "modal" aria-hidden = "true" > × </botón>
  4. <h3> Cabecera modal </h3>
  5. </div>
  6. <div clase = "cuerpo-modal" >
  7. <p> Un buen cuerpo... </p>
  8. </div>
  9. <div clase = "modal-pie de página" >
  10. <a href = "#" class = "btn" > Cerrar </a>
  11. <a href = "#" class = "btn btn-primary" > Guardar cambios </a>
  12. </div>
  13. </div>

Demo en vivo

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.

  1. <!-- Botón para activar modal -->
  2. <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Iniciar demostración modal </a>
  3.  
  4. <!-- Modales -->
  5. <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
  6. < clase div = "encabezado-modal" >
  7. < tipo de botón = "botón" clase = "cerrar" datos-descartar = "modal" aria-hidden = "verdadero" > × </botón>
  8. <h3 id = "myModalLabel" > Cabecera modal </h3>
  9. </div>
  10. <div clase = "cuerpo-modal" >
  11. <p> Un buen cuerpo... </p>
  12. </div>
  13. <div clase = "modal-pie de página" >
  14. <button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Cerrar </button>
  15. <button class = "btn btn-primary" > Guardar cambios </button>
  16. </div>
  17. </div>

Uso

A través de atributos de datos

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.

  1. <button type = "button" data-toggle = "modal" data-target = "#myModal" > Iniciar modal </button>

A través de JavaScript

Llame a un modal con id myModalcon una sola línea de JavaScript:

  1. $ ( '#miModal' ). modal ( opciones )

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 staticun 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 loadmétodo de jQuery y se inyectará en el archivo .modal-body. Si está utilizando la API de datos, también puede usar la hrefetiqueta para especificar la fuente remota. Un ejemplo de esto se muestra a continuación:

  1. <a data-toggle="modal" href="remote.html" data-target="#modal">click me</a>

Métodos

.modal(opciones)

Activa tu contenido como modal. Acepta opciones opcionales object.

  1. $ ( '#miModal' ). modales ({
  2. teclado : falso
  3. })

.modal('alternar')

Cambia manualmente un modal.

  1. $ ( '#miModal' ). modal ( 'alternar' )

.modal('mostrar')

Abre manualmente un modal.

  1. $ ( '#miModal' ). modal ( 'mostrar' )

.modal('ocultar')

Oculta manualmente un modal.

  1. $ ( '#miModal' ). modal ( 'ocultar' )

Eventos

La clase modal de Bootstrap expone algunos eventos para conectarse a la funcionalidad modal.

Evento Descripción
mostrar Este evento se activa inmediatamente cuando showse 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 hidese 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).
  1. $ ( '#miModal' ). en ( 'oculto' , función () {
  2. // hacer algo…
  3. })

Ejemplo en la barra de navegación

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.

@grasa

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.

@mdo

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.

una

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.

dos

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.

three

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.


Uso

A través de atributos de datos

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 .navcomponente.

  1. <body data-spy = "scroll" data-target = ".navbar" > ... </body>

A través de JavaScript

Llame al scrollspy a través de JavaScript:

  1. $ ( '#barra de navegación' ). scrollspy ()
¡Aviso! Los enlaces de la barra de navegación deben tener objetivos de identificación resolubles. Por ejemplo, a <a href="#home">home</a>debe corresponder a algo en el dom como <div id="home"></div>.

Métodos

.scrollspy('actualizar')

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:

  1. $ ( '[data-spy="scroll"]' ). cada ( función () {
  2. var $espía = $ ( esto ). scrollspy ( 'actualizar' )
  3. });

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-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.

Eventos

Evento Descripción
activar Este evento se activa cada vez que el scrollspy activa un nuevo elemento.

Pestañas de ejemplo

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.


Uso

Habilite las pestañas que se pueden tabular a través de JavaScript (cada pestaña debe activarse individualmente):

  1. $ ( '#myTab a' ). hacer clic ( función ( e ) {
  2. mi . prevenirPredeterminado ();
  3. $ ( esto ). tabulador ( 'mostrar' );
  4. })

Puede activar pestañas individuales de varias maneras:

  1. $ ( '#myTab a[href="#perfil"]' ). tabulador ( 'mostrar' ); // Seleccionar pestaña por nombre
  2. $ ( '#myTab a:first' ). tabulador ( 'mostrar' ); // Selecciona la primera pestaña
  3. $ ( '#myTab a: last' ). tabulador ( 'mostrar' ); //Seleccionar última pestaña
  4. $ ( '#miTab li:eq(2) a' ). tabulador ( 'mostrar' ); // Seleccione la tercera pestaña (0-indexado)

Margen

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 navy a la pestaña aplicará el estilo de la pestaña Bootstrap.nav-tabsul

  1. <ul class = "nav nav-tabs" >
  2. <li><a href = "#home" data-toggle = "tab" > Inicio </a></li>
  3. <li><a href = "#profile" data-toggle = "tab" > Perfil </a></li>
  4. <li><a href = "#mensajes" data-toggle = "tab" > Mensajes </a></li>
  5. <li><a href = "#settings" data-toggle = "tab" > Configuración </a></li>
  6. </ul>

Métodos

$().pestaña

Activa un elemento de pestaña y un contenedor de contenido. La pestaña debe tener un data-targeto un hrefnodo contenedor en el DOM.

  1. <ul class = "nav nav-tabs" id = "myTab" >
  2. <li class = "active" ><a href = "#home" > Inicio </a></li>
  3. <li><a href = "#perfil" > Perfil </a></li>
  4. <li><a href = "#mensajes" > Mensajes </a></li>
  5. <li><a href = "#settings" > Configuración </a></li>
  6. </ul>
  7.  
  8. < clase div = "contenido de la pestaña" >
  9. <div class = "tab-pane active" id = "home" > ... </div>
  10. <div class = "tab-pane" id = "perfil" > ... </div>
  11. <div clase = "panel de pestañas" id = "mensajes" > ... </div>
  12. <div clase = "panel de pestañas" id = "configuración" > ... </div>
  13. </div>
  14.  
  15. <script>
  16. $ ( función () {
  17. $ ( '#myTab a: last' ). tabulador ( 'mostrar' );
  18. })
  19. </script>

Eventos

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.targety event.relatedTargetpara 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.targety event.relatedTargetpara apuntar a la pestaña activa y la pestaña activa anterior (si está disponible) respectivamente.
  1. $ ( 'a[cambio de datos="tab"]' ). en ( 'mostrado' , función ( e ) {
  2. mi . objetivo // pestaña activada
  3. mi . objetivo relacionado // pestaña anterior
  4. })

Ejemplos

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 .

cuatro direcciones

Información sobre herramientas en grupos de entrada

Cuando use información sobre herramientas y ventanas emergentes con los grupos de entrada de Bootstrap, deberá configurar la containeropción (documentada a continuación) para evitar efectos secundarios no deseados.


Uso

Active la información sobre herramientas a través de JavaScript:

  1. $ ( '#ejemplo' ). información sobre herramientas ( opciones )

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 textusará 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:delay: { show: 500, hide: 100 }

envase cadena | falso falso

Agrega la información sobre herramientas a un elemento específicocontainer: 'body'

¡Aviso! Las opciones para información sobre herramientas individuales se pueden especificar alternativamente mediante el uso de atributos de datos.

Margen

  1. <a href = "#" data-toggle = "tooltip" title = "primera información sobre herramientas" > pasa el cursor sobre mí </a>

Métodos

$().información sobre herramientas(opciones)

Adjunta un controlador de información sobre herramientas a una colección de elementos.

.tooltip('mostrar')

Revela la información sobre herramientas de un elemento.

  1. $ ( '#elemento' ). información sobre herramientas ( 'mostrar' )

.tooltip('ocultar')

Oculta la información sobre herramientas de un elemento.

  1. $ ( '#elemento' ). información sobre herramientas ( 'ocultar' )

.tooltip('alternar')

Alterna la información sobre herramientas de un elemento.

  1. $ ( '#elemento' ). información sobre herramientas ( 'alternar' )

.tooltip('destruir')

Oculta y destruye la información sobre herramientas de un elemento.

  1. $ ( '#elemento' ). información sobre herramientas ( 'destruir' )

Ejemplos

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.

ventana emergente estática

Hay cuatro opciones disponibles: alineación superior, derecha, inferior e izquierda.

Top popover

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

ventana emergente a la derecha

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

parte inferior popover

Sed posuere consectetur est at lobortis. Aenean eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Ventana emergente a la izquierda

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 dataatributo.

Demo en vivo

cuatro direcciones


Uso

Habilitar ventanas emergentes a través de JavaScript:

  1. $ ( '#ejemplo' ). ventana emergente ( opciones )

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 textusará 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 disparo manual

Si se proporciona un número, la demora se aplica tanto para ocultar/mostrar

La estructura del objeto es:delay: { show: 500, hide: 100 }

envase cadena | falso falso

Agrega el popover a un elemento específicocontainer: 'body'

¡Aviso! Las opciones para ventanas emergentes individuales se pueden especificar alternativamente mediante el uso de atributos de datos.

Margen

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.

Métodos

$().popover(opciones)

Inicializa popovers para una colección de elementos.

.popover('mostrar')

Revela una ventana emergente de elementos.

  1. $ ( '#elemento' ). popover ( 'mostrar' )

.popover('ocultar')

Oculta una ventana emergente de elementos.

  1. $ ( '#elemento' ). popover ( 'ocultar' )

.popover('alternar')

Alterna una ventana emergente de elementos.

  1. $ ( '#elemento' ). popover ( 'alternar' )

.popover('destruir')

Oculta y destruye el popover de un elemento.

  1. $ ( '#elemento' ). popover ( 'destruir' )

Alertas de ejemplo

Agregue la funcionalidad de descartar a todos los mensajes de alerta con este complemento.

¡Santo guacamole! Será mejor que lo compruebes tú mismo, no te ves muy bien.

¡Oh, chasquido! ¡Tienes un error!

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.

Toma esta acción o haz esto


Uso

Habilite el rechazo de una alerta a través de JavaScript:

  1. $ ( ".alerta" ). alerta ()

Margen

Simplemente agréguelo data-dismiss="alert"a su botón de cierre para dar automáticamente una funcionalidad de cierre de alerta.

  1. <a class = "close" data-dismiss = "alert" href = "#" > × </a>

Métodos

$().alerta()

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 .fadey ..in

.alert('cerrar')

Cierra una alerta.

  1. $ ( ".alerta" ). alerta ( 'cerrar' )

Eventos

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 closese 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).
  1. $ ( '#mi-alerta' ). enlazar ( 'cerrado' , función () {
  2. // hacer algo…
  3. })

Ejemplos de usos

Haz más con los botones. Controle los estados de los botones o cree grupos de botones para más componentes, como barras de herramientas.

con estado

Agregar data-loading-text="Loading..."para usar un estado de carga en un botón.

  1. <button type = "button" class = "btn btn-primary" data-loading-text = "Cargando..." > Estado de carga </button>

Cambio único

Agregue data-toggle="button"para activar alternar en un solo botón.

  1. < tipo de botón = "botón" clase = "btn btn-primary" alternancia de datos = "botón" > Cambio único </botón>

Caja

Agregue data-toggle="buttons-checkbox"para alternar el estilo de casilla de verificación en btn-group.

  1. <div class = "btn-group" data-toggle = "buttons-checkbox" >
  2. < tipo de botón = "botón" clase = "btn btn-primary" > Izquierda </button>
  3. < tipo de botón = "botón" clase = "btn btn-primary" > Medio </button>
  4. < tipo de botón = "botón" clase = "btn btn-primary" > Derecha </button>
  5. </div>

Radio

Agregue data-toggle="buttons-radio"para alternar el estilo de radio en btn-group.

  1. <div class = "btn-group" data-toggle = "buttons-radio" >
  2. < tipo de botón = "botón" clase = "btn btn-primary" > Izquierda </button>
  3. < tipo de botón = "botón" clase = "btn btn-primary" > Medio </button>
  4. < tipo de botón = "botón" clase = "btn btn-primary" > Derecha </button>
  5. </div>

Uso

Habilitar botones a través de JavaScript:

  1. $ ( '.nav-tabs' ). botón ()

Margen

Los atributos de datos son parte integral del complemento del botón. Consulte el código de ejemplo a continuación para ver los distintos tipos de marcado.

Opciones

Ninguna

Métodos

$().button('alternar')

Cambia el estado de inserción. Da al botón la apariencia de que ha sido activado.

¡Aviso! Puede habilitar el cambio automático de un botón usando el data-toggleatributo.
  1. < tipo de botón = "botón" clase = "btn" alternar datos = "botón" > </botón>

$().button('cargando')

Establece el estado del botón en carga: desactiva el botón y cambia el texto por el texto de carga. El texto de carga debe definirse en el elemento del botón usando el atributo de datos data-loading-text.

  1. <button type = "button" class = "btn" data-loading-text = "cargando cosas..." > ... </button>
¡Aviso! Firefox persiste en el estado deshabilitado al cargar la página . Una solución para esto es usar autocomplete="off".

$().button('restablecer')

Restablece el estado del botón: cambia el texto al texto original.

$().button(cadena)

Restablece el estado del botón: cambia el texto a cualquier estado de texto definido por datos.

  1. < tipo de botón = "botón" clase = "btn" texto completo de datos = "¡terminado!" > ... </botón>
  2. <script>
  3. $ ( '.btn' ). botón ( 'completar' )
  4. </script>

Sobre

Obtenga estilos básicos y soporte flexible para componentes plegables como acordeones y navegación.

* Requiere que se incluya el complemento Transiciones.

acordeón de ejemplo

Usando el complemento de colapso, construimos un widget de estilo acordeón simple:

Anim pariatur cliché reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon oficia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 lobo luna tempor, sunt aliqua puso un pájaro en él calamares café de origen único nulla asunción shoreditch et. Nihil anim keffiyeh helvetica, cerveza artesanal labore wes anderson cred nesciunt sapiente ea proident. Anuncio vegano excepteur carnicero vice lomo. Leggings occaecat cerveza artesanal de la granja a la mesa, denim crudo estética sintetizador nesciunt probablemente no hayas oído hablar de ellos accusamus labore sostenible VHS.
Anim pariatur cliché reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon oficia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 lobo luna tempor, sunt aliqua puso un pájaro en él calamares café de origen único nulla asunción shoreditch et. Nihil anim keffiyeh helvetica, cerveza artesanal labore wes anderson cred nesciunt sapiente ea proident. Anuncio vegano excepteur carnicero vice lomo. Leggings occaecat cerveza artesanal de la granja a la mesa, denim crudo estética sintetizador nesciunt probablemente no hayas oído hablar de ellos accusamus labore sostenible VHS.
Anim pariatur cliché reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon oficia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 lobo luna tempor, sunt aliqua puso un pájaro en él calamares café de origen único nulla asunción shoreditch et. Nihil anim keffiyeh helvetica, cerveza artesanal labore wes anderson cred nesciunt sapiente ea proident. Anuncio vegano excepteur carnicero vice lomo. Leggings occaecat cerveza artesanal de la granja a la mesa, denim crudo estética sintetizador nesciunt probablemente no hayas oído hablar de ellos accusamus labore sostenible VHS.
  1. <div class = "acordeón" id = "acordeón2" >
  2. <div clase = "grupo-acordeón" >
  3. <div clase = "título-acordeón" >
  4. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
  5. Artículo de grupo plegable n.º 1
  6. </a>
  7. </div>
  8. <div id = "collapseOne" class = "cuerpo de acordeón colapsar en" >
  9. <div clase = "acordeón-interior" >
  10. Anim pariatur cliché...
  11. </div>
  12. </div>
  13. </div>
  14. <div clase = "grupo-acordeón" >
  15. <div clase = "título-acordeón" >
  16. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
  17. Artículo de grupo plegable n.º 2
  18. </a>
  19. </div>
  20. <div id = "collapseTwo" class = "colapso del cuerpo del acordeón" >
  21. <div clase = "acordeón-interior" >
  22. Anim pariatur cliché...
  23. </div>
  24. </div>
  25. </div>
  26. </div>
  27. ...

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.

  1. < tipo de botón = "botón" clase = "btn btn-peligro" alternar datos = "contraer" objetivo de datos = "#demo" >
  2. plegable simple
  3. </botón>
  4.  
  5. <div id = "demo" class = "contraer en" > </div>

Uso

A través de atributos de datos

Simplemente agregue data-toggle="collapse"y un data-targetelemento para asignar automáticamente el control de un elemento contraíble. El data-targetatributo acepta un selector css para aplicar el colapso. Asegúrese de agregar la clase collapseal 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.

A través de JavaScript

Habilitar manualmente con:

  1. $ ( ".contraer" ). colapso ()

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-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

Métodos

.collapse(opciones)

Activa tu contenido como un elemento colapsable. Acepta opciones opcionales object.

  1. $ ( '#myCollapsible' ). colapsar ({
  2. alternar : falso
  3. })

.collapse('alternar')

Cambia un elemento colapsable a mostrado u oculto.

.collapse('mostrar')

Muestra un elemento plegable.

.collapse('ocultar')

Oculta un elemento contraíble.

Eventos

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 showse 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 hidese 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).
  1. $ ( '#myCollapsible' ). en ( 'oculto' , función () {
  2. // hacer algo…
  3. })

Ejemplo

Un complemento básico y fácilmente ampliable para crear rápidamente mecanografiados elegantes con cualquier tipo de entrada de texto.

  1. < tipo de entrada = "texto" suministro de datos = "escribir por adelantado" >

Querrá configurar autocomplete="off"para evitar que los menús predeterminados del navegador aparezcan sobre el menú desplegable de escritura anticipada de Bootstrap.


Uso

A través de atributos de datos

Agregue atributos de datos para registrar un elemento con la funcionalidad de escritura anticipada como se muestra en el ejemplo anterior.

A través de JavaScript

Llame al typeahead manualmente con:

  1. $ ( '.escribir por adelantado' ). escribir adelante ()

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-source="".

Nombre escribe defecto descripción
fuente matriz, función [ ] La fuente de datos contra la que se va a realizar la consulta. Puede ser una matriz de cadenas o una función. A la función se le pasan dos argumentos, el queryvalor en el campo de entrada y la processdevolución de llamada. La función se puede usar de forma síncrona al devolver la fuente de datos directamente o de forma asíncrona a través processdel único argumento de la devolución de llamada.
elementos número 8 El número máximo de elementos para mostrar en el menú desplegable.
longitud mínima número 1 La longitud mínima de caracteres necesaria antes de activar las sugerencias de autocompletar
emparejador función mayúsculas y minúsculas El método utilizado para determinar si una consulta coincide con un elemento. Acepta un solo argumento, itemcontra el cual probar la consulta. Accede a la consulta actual con this.query. Devuelve un booleano truesi la consulta es una coincidencia.
clasificador función coincidencia exacta,
mayúsculas y minúsculas,
mayúsculas y minúsculas
Método utilizado para ordenar los resultados de autocompletar. Acepta un solo argumento itemsy tiene el alcance de la instancia de escritura anticipada. Haga referencia a la consulta actual con this.query.
actualizador función devuelve el elemento seleccionado El método utilizado para devolver el elemento seleccionado. Acepta un solo argumento, el itemy tiene el alcance de la instancia de escritura anticipada.
resaltador función resalta todas las coincidencias predeterminadas Método utilizado para resaltar los resultados de autocompletar. Acepta un solo argumento itemy tiene el alcance de la instancia de escritura anticipada. Debería devolver html.

Métodos

.typeahead (opciones)

Inicializa una entrada con una escritura anticipada.

Ejemplo

La subnavegación a la izquierda es una demostración en vivo del complemento de afijo.


Uso

A través de atributos de datos

Para agregar fácilmente un comportamiento de afijo a cualquier elemento, simplemente agréguelo data-spy="affix"al elemento que desea espiar. A continuación, utilice las compensaciones para definir cuándo activar y desactivar la fijación de un elemento.

  1. <div data-spy = "affix" data-offset-top = "200" > ... </div>
¡Aviso! Debe administrar la posición de un elemento anclado y el comportamiento de su padre inmediato. La posición está controlada por affix, affix-topy affix-bottom. Recuerde verificar si hay un padre potencialmente colapsado cuando el afijo se active, ya que está eliminando contenido del flujo normal de la página.

A través de JavaScript

Llame al complemento de afijo a través de JavaScript:

  1. $ ( '#barra de navegación' ). afijo ()

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-offset-top="200".

Nombre escribe defecto descripción
compensar número | función | objeto 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).