Visión general

Individual o compilado

Los complementos se pueden incluir individualmente (usando los *.jsarchivos individuales de Bootstrap) o todos a la vez (usando bootstrap.jso minificado bootstrap.min.js).

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 función. Por lo tanto, también brindamos la posibilidad de deshabilitar la API de atributos de datos al desvincular todos los eventos en el espacio de nombres del documento con data-api. Esto se ve así:

$(document).off('.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:

$(document).off('.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.

$('.btn.danger').button('toggle').addClass('fat')

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

$('#myModal').modal()                      // initialized with defaults
$('#myModal').modal({ keyboard: false })   // initialized with no keyboard
$('#myModal').modal('show')                // initializes and invokes show immediately

Cada complemento también expone su constructor sin procesar en una Constructorpropiedad: $.fn.popover.Constructor. Si desea obtener una instancia de complemento en particular, recupérela directamente de un elemento: $('[rel="popover"]').data('popover').

Configuración por defecto

Puede cambiar la configuración predeterminada de un complemento modificando el Constructor.DEFAULTSobjeto del complemento:

$.fn.modal.Constructor.DEFAULTS.keyboard = false // changes default for the modal plugin's `keyboard` option to false

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.

var bootstrapButton = $.fn.button.noConflict() // return $.fn.button to previously assigned value
$.fn.bootstrapBtn = bootstrapButton            // give $().bootstrapBtn the Bootstrap functionality

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. shown) se activa al completar una acción.

A partir de la versión 3.0.0, todos los eventos de Bootstrap tienen espacios de nombres.

Todos los eventos de infinitivo proporcionan preventDefaultfuncionalidad. Esto proporciona la capacidad de detener la ejecución de una acción antes de que comience.

$('#myModal').on('show.bs.modal', function (e) {
  if (!data) return e.preventDefault() // stops modal from being shown
})

Desinfectante

La información sobre herramientas y las ventanas emergentes utilizan nuestro desinfectante incorporado para desinfectar las opciones que aceptan HTML.

El valor predeterminado whiteListes el siguiente:

var ARIA_ATTRIBUTE_PATTERN = /^aria-[\w-]*$/i
var DefaultWhitelist = {
  // Global attributes allowed on any supplied element below.
  '*': ['class', 'dir', 'id', 'lang', 'role', ARIA_ATTRIBUTE_PATTERN],
  a: ['target', 'href', 'title', 'rel'],
  area: [],
  b: [],
  br: [],
  col: [],
  code: [],
  div: [],
  em: [],
  hr: [],
  h1: [],
  h2: [],
  h3: [],
  h4: [],
  h5: [],
  h6: [],
  i: [],
  img: ['src', 'alt', 'title', 'width', 'height'],
  li: [],
  ol: [],
  p: [],
  pre: [],
  s: [],
  small: [],
  span: [],
  sub: [],
  sup: [],
  strong: [],
  u: [],
  ul: []
}

Si desea agregar nuevos valores a este valor predeterminado whiteList, puede hacer lo siguiente:

var myDefaultWhiteList = $.fn.tooltip.Constructor.DEFAULTS.whiteList

// To allow table elements
myDefaultWhiteList.table = []

// To allow td elements and data-option attributes on td elements
myDefaultWhiteList.td = ['data-option']

// You can push your custom regex to validate your attributes.
// Be careful about your regular expressions being too lax
var myCustomRegex = /^data-my-app-[\w-]+/
myDefaultWhiteList['*'].push(myCustomRegex)

Si desea omitir nuestro desinfectante porque prefiere usar una biblioteca dedicada, por ejemplo , DOMPurify , debe hacer lo siguiente:

$('#yourTooltip').tooltip({
  sanitizeFn: function (content) {
    return DOMPurify.sanitize(content)
  }
})

Números de versión

Se puede acceder a la versión de cada uno de los complementos jQuery de Bootstrap a través de la VERSIONpropiedad del constructor del complemento. Por ejemplo, para el complemento de información sobre herramientas:

$.fn.tooltip.Constructor.VERSION // => "3.4.1"

No hay respaldos especiales cuando JavaScript está deshabilitado

Los complementos de Bootstrap no se recuperan de manera particularmente elegante cuando JavaScript está deshabilitado. Si le importa la experiencia del usuario en este caso, utilícelo <noscript>para explicar la situación (y cómo volver a habilitar JavaScript) a sus usuarios y/o agregue sus propios recursos alternativos personalizados.

Transiciones transición.js

Acerca de las transiciones

Para efectos de transición simples, incluya transition.jsuna vez junto con los otros archivos JS. Si está utilizando el compilado (o minimizado) bootstrap.js, no es necesario incluirlo, ya está allí.

Qué hay adentro

Transition.js es un ayudante básico para transitionEndeventos, así como un emulador de transición CSS. Los otros complementos lo utilizan para verificar la compatibilidad con la transición de CSS y para detectar transiciones colgantes.

Deshabilitar transiciones

Las transiciones se pueden deshabilitar globalmente usando el siguiente fragmento de código de JavaScript, que debe aparecer después de que se haya cargado transition.js(o bootstrap.jso bootstrap.min.js, según sea el caso):

$.support.transition = false

Modales modal.js

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

Debido a cómo HTML5 define su semántica, el autofocusatributo HTML no tiene efecto en los modales de Bootstrap. Para lograr el mismo efecto, use JavaScript personalizado:

$('#myModal').on('shown.bs.modal', function () {
  $('#myInput').focus()
})

Ejemplos

Ejemplo estático

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

<div class="modal fade" tabindex="-1" role="dialog">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
        <h4 class="modal-title">Modal title</h4>
      </div>
      <div class="modal-body">
        <p>One fine body&hellip;</p>
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div><!-- /.modal-content -->
  </div><!-- /.modal-dialog -->
</div><!-- /.modal -->

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.

<!-- Button trigger modal -->
<button type="button" class="btn btn-primary btn-lg" data-toggle="modal" data-target="#myModal">
  Launch demo modal
</button>

<!-- Modal -->
<div class="modal fade" id="myModal" tabindex="-1" role="dialog" aria-labelledby="myModalLabel">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
        <h4 class="modal-title" id="myModalLabel">Modal title</h4>
      </div>
      <div class="modal-body">
        ...
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div>
  </div>
</div>

Tamaños opcionales

Los modales tienen dos tamaños opcionales, disponibles a través de clases de modificadores para colocar en un archivo .modal-dialog.

<!-- Large modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target=".bs-example-modal-lg">Large modal</button>

<div class="modal fade" tabindex="-1" role="dialog" aria-labelledby="myLargeModalLabel">
  <div class="modal-dialog modal-lg" role="document">
    <div class="modal-content">
      ...
    </div>
  </div>
</div>

<!-- Small modal -->
<button type="button" class="btn btn-primary" data-toggle="modal" data-target=".bs-example-modal-sm">Small modal</button>

<div class="modal fade" tabindex="-1" role="dialog" aria-labelledby="mySmallModalLabel">
  <div class="modal-dialog modal-sm" role="document">
    <div class="modal-content">
      ...
    </div>
  </div>
</div>

Eliminar animación

Para los modales que simplemente aparecen en lugar de aparecer gradualmente, elimine la .fadeclase de su marcado modal.

<div class="modal" tabindex="-1" role="dialog" aria-labelledby="...">
  ...
</div>

Usando el sistema de cuadrícula

Para aprovechar el sistema de cuadrícula Bootstrap dentro de un modal, simplemente anide .rows dentro de .modal-bodyy luego use las clases normales del sistema de cuadrícula.

<div class="modal fade" tabindex="-1" role="dialog" aria-labelledby="gridSystemModalLabel">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
        <h4 class="modal-title" id="gridSystemModalLabel">Modal title</h4>
      </div>
      <div class="modal-body">
        <div class="row">
          <div class="col-md-4">.col-md-4</div>
          <div class="col-md-4 col-md-offset-4">.col-md-4 .col-md-offset-4</div>
        </div>
        <div class="row">
          <div class="col-md-3 col-md-offset-3">.col-md-3 .col-md-offset-3</div>
          <div class="col-md-2 col-md-offset-4">.col-md-2 .col-md-offset-4</div>
        </div>
        <div class="row">
          <div class="col-md-6 col-md-offset-3">.col-md-6 .col-md-offset-3</div>
        </div>
        <div class="row">
          <div class="col-sm-9">
            Level 1: .col-sm-9
            <div class="row">
              <div class="col-xs-8 col-sm-6">
                Level 2: .col-xs-8 .col-sm-6
              </div>
              <div class="col-xs-4 col-sm-6">
                Level 2: .col-xs-4 .col-sm-6
              </div>
            </div>
          </div>
        </div>
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div><!-- /.modal-content -->
  </div><!-- /.modal-dialog -->
</div><!-- /.modal -->

Contenido modal variable basado en el botón de activación

¿Tiene un montón de botones que activan el mismo modal, solo que con contenidos ligeramente diferentes? Use event.relatedTargetlos atributos HTMLdata-* (posiblemente a través de jQuery ) para variar el contenido del modal según el botón en el que se hizo clic. Consulte los documentos Modal Events para obtener detalles sobre relatedTarget,

<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal" data-whatever="@mdo">Open modal for @mdo</button>
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal" data-whatever="@fat">Open modal for @fat</button>
<button type="button" class="btn btn-primary" data-toggle="modal" data-target="#exampleModal" data-whatever="@getbootstrap">Open modal for @getbootstrap</button>
...more buttons...

<div class="modal fade" id="exampleModal" tabindex="-1" role="dialog" aria-labelledby="exampleModalLabel">
  <div class="modal-dialog" role="document">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
        <h4 class="modal-title" id="exampleModalLabel">New message</h4>
      </div>
      <div class="modal-body">
        <form>
          <div class="form-group">
            <label for="recipient-name" class="control-label">Recipient:</label>
            <input type="text" class="form-control" id="recipient-name">
          </div>
          <div class="form-group">
            <label for="message-text" class="control-label">Message:</label>
            <textarea class="form-control" id="message-text"></textarea>
          </div>
        </form>
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-default" data-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Send message</button>
      </div>
    </div>
  </div>
</div>

$('#exampleModal').on('show.bs.modal', function (event) {
  var button = $(event.relatedTarget) // Button that triggered the modal
  var recipient = button.data('whatever') // Extract info from data-* attributes
  // If necessary, you could initiate an AJAX request here (and then do the updating in a callback).
  // Update the modal's content. We'll use jQuery here, but you could use a data binding library or other methods instead.
  var modal = $(this)
  modal.find('.modal-title').text('New message to ' + recipient)
  modal.find('.modal-body input').val(recipient)
})

Uso

El complemento modal alterna su contenido oculto a pedido, a través de atributos de datos o JavaScript. También se agrega .modal-openpara <body>anular el comportamiento de desplazamiento predeterminado y genera un .modal-backdroppara proporcionar un área de clic para descartar los modales mostrados al hacer clic fuera del modal.

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.

<button type="button" data-toggle="modal" data-target="#myModal">Launch modal</button>

A través de JavaScript

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

$('#myModal').modal(options)

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

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

Métodos

.modal(options)

Activa tu contenido como modal. Acepta opciones opcionales object.

$('#myModal').modal({
  keyboard: false
})

.modal('toggle')

Cambia manualmente un modal. Vuelve a la persona que llama antes de que se haya mostrado u ocultado el modal (es decir, antes de que ocurra el evento shown.bs.modalo ).hidden.bs.modal

$('#myModal').modal('toggle')

.modal('show')

Abre manualmente un modal. Vuelve a la persona que llama antes de que se haya mostrado realmente el modal (es decir, antes de shown.bs.modalque ocurra el evento).

$('#myModal').modal('show')

.modal('hide')

Oculta manualmente un modal. Vuelve a la persona que llama antes de que se haya ocultado realmente el modal (es decir, antes de hidden.bs.modalque ocurra el evento).

$('#myModal').modal('hide')

.modal('handleUpdate')

Reajusta el posicionamiento del modal para contrarrestar una barra de desplazamiento en caso de que aparezca una, lo que haría que el modal salte hacia la izquierda.

Solo es necesario cuando la altura del modal cambia mientras está abierto.

$('#myModal').modal('handleUpdate')

Eventos

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

Todos los eventos modales se activan en el propio modal (es decir, en el <div class="modal">).

$('#myModal').on('hidden.bs.modal', function (e) {
  // do something...
})

Menús desplegables dropdown.js

Ejemplos

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.

Dentro de una barra de navegación

dentro de pastillas

Uso

A través de atributos de datos o JavaScript, el complemento desplegable alterna el contenido oculto (menús desplegables) al alternar la .openclase en el elemento de la lista principal.

En los dispositivos móviles, al abrir un menú desplegable se agrega un .dropdown-backdropárea de toque para cerrar los menús desplegables al tocar fuera del menú, un requisito para la compatibilidad adecuada con iOS. Esto significa que cambiar de un menú desplegable abierto a un menú desplegable diferente requiere un toque adicional en el dispositivo móvil.

Nota: Se data-toggle="dropdown"confía en el atributo para cerrar los menús desplegables a nivel de aplicación, por lo que es una buena idea usarlo siempre.

A través de atributos de datos

Agregue data-toggle="dropdown"a un enlace o botón para alternar un menú desplegable.

<div class="dropdown">
  <button id="dLabel" type="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
    Dropdown trigger
    <span class="caret"></span>
  </button>
  <ul class="dropdown-menu" aria-labelledby="dLabel">
    ...
  </ul>
</div>

Para mantener las URL intactas con los botones de enlace, use el data-targetatributo en lugar de href="#".

<div class="dropdown">
  <a id="dLabel" data-target="#" href="http://example.com/" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">
    Dropdown trigger
    <span class="caret"></span>
  </a>

  <ul class="dropdown-menu" aria-labelledby="dLabel">
    ...
  </ul>
</div>

A través de JavaScript

Llame a los menús desplegables a través de JavaScript:

$('.dropdown-toggle').dropdown()

Opciones

Ninguna

Métodos

$().dropdown('toggle')

Alterna el menú desplegable de una barra de navegación determinada o navegación con pestañas.

Eventos

Todos los eventos desplegables se activan en el .dropdown-menuelemento principal de .

Todos los eventos desplegables tienen una relatedTargetpropiedad, cuyo valor es el elemento ancla de alternancia.

$('#myDropdown').on('show.bs.dropdown', function () {
  // do something…
})

ScrollSpy scrollspy.js

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.

Uso

Requiere posicionamiento relativo

Independientemente del método de implementación, scrollspy requiere el uso de position: relative;en el elemento que está espiando. En la mayoría de los casos, este es el <body>. Al hacer scrollspy en elementos que no sean el <body>, asegúrese de tener un heightconjunto y overflow-y: scroll;aplicarlo.

A través de atributos de datos

Para agregar fácilmente el comportamiento de scrollspy a la navegación de la barra superior, agregue data-spy="scroll"el elemento que desea espiar (por lo general, este sería el <body>). Luego agregue el data-targetatributo con el ID o la clase del elemento principal de cualquier .navcomponente de Bootstrap.

body {
  position: relative;
}

<body data-spy="scroll" data-target="#navbar-example">
  ...
  <div id="navbar-example">
    <ul class="nav nav-tabs" role="tablist">
      ...
    </ul>
  </div>
  ...
</body>

A través de JavaScript

Después de agregar position: relative;su CSS, llame a scrollspy a través de JavaScript:

$('body').scrollspy({ target: '#navbar-example' })

Métodos

.scrollspy('refresh')

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"]').each(function () {
  var $spy = $(this).scrollspy('refresh')
})

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

Eventos

$('#myScrollspy').on('activate.bs.scrollspy', function () {
  // do something…
})

Pestañas conmutables tab.js

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. Las pestañas anidadas no son compatibles.

Uso

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

$('#myTabs a').click(function (e) {
  e.preventDefault()
  $(this).tab('show')
})

Puede activar pestañas individuales de varias maneras:

$('#myTabs a[href="#profile"]').tab('show') // Select tab by name
$('#myTabs a:first').tab('show') // Select first tab
$('#myTabs a:last').tab('show') // Select last tab
$('#myTabs li:eq(2) a').tab('show') // Select third tab (0-indexed)

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 , mientras que agregar las clases y aplicará el estilo de la píldora .nav-tabsulnavnav-pills

<div>

  <!-- Nav tabs -->
  <ul class="nav nav-tabs" role="tablist">
    <li role="presentation" class="active"><a href="#home" aria-controls="home" role="tab" data-toggle="tab">Home</a></li>
    <li role="presentation"><a href="#profile" aria-controls="profile" role="tab" data-toggle="tab">Profile</a></li>
    <li role="presentation"><a href="#messages" aria-controls="messages" role="tab" data-toggle="tab">Messages</a></li>
    <li role="presentation"><a href="#settings" aria-controls="settings" role="tab" data-toggle="tab">Settings</a></li>
  </ul>

  <!-- Tab panes -->
  <div class="tab-content">
    <div role="tabpanel" class="tab-pane active" id="home">...</div>
    <div role="tabpanel" class="tab-pane" id="profile">...</div>
    <div role="tabpanel" class="tab-pane" id="messages">...</div>
    <div role="tabpanel" class="tab-pane" id="settings">...</div>
  </div>

</div>

Efecto de desvanecimiento

Para hacer que las pestañas se desvanezcan, agréguelas .fadea cada .tab-pane. El primer panel de pestañas también debe tener .inpara hacer visible el contenido inicial.

<div class="tab-content">
  <div role="tabpanel" class="tab-pane fade in active" id="home">...</div>
  <div role="tabpanel" class="tab-pane fade" id="profile">...</div>
  <div role="tabpanel" class="tab-pane fade" id="messages">...</div>
  <div role="tabpanel" class="tab-pane fade" id="settings">...</div>
</div>

Métodos

$().tab

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. En los ejemplos anteriores, las pestañas son las <a>s con data-toggle="tab"atributos.

.tab('show')

Selecciona la pestaña dada y muestra su contenido asociado. Cualquier otra pestaña que se haya seleccionado previamente se deselecciona y su contenido asociado se oculta. Vuelve a la persona que llama antes de que se haya mostrado realmente el panel de pestañas (es decir, antes de shown.bs.tabque ocurra el evento).

$('#someTab').tab('show')

Eventos

Al mostrar una nueva pestaña, los eventos se activan en el siguiente orden:

1. hide.bs.tab(en la pestaña activa actual)
2. show.bs.tab(en la pestaña que se mostrará)
3. hidden.bs.tab(en la pestaña activa anterior, la misma que para el hide.bs.tabevento)
4. shown.bs.tab(en la pestaña recién activa recién mostrada, la misma que para el show.bs.tabevento)

Si ninguna pestaña ya estaba activa, los eventos hide.bs.taby hidden.bs.tabno se activarán.

$('a[data-toggle="tab"]').on('shown.bs.tab', function (e) {
  e.target // newly activated tab
  e.relatedTarget // previous active tab
})

Información sobre herramientas tooltip.js

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.

La información sobre herramientas con títulos de longitud cero nunca se muestra.

Ejemplos

Pase el cursor sobre los enlaces a continuación para ver información sobre herramientas:

Información sobre herramientas estática

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

cuatro direcciones

<button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="left" title="Tooltip on left">Tooltip on left</button>

<button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="top" title="Tooltip on top">Tooltip on top</button>

<button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="bottom" title="Tooltip on bottom">Tooltip on bottom</button>

<button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="right" title="Tooltip on right">Tooltip on right</button>

$(function () {
  $('[data-toggle="tooltip"]').tooltip()
})

Uso

El complemento de información sobre herramientas genera contenido y marcado a pedido y, de forma predeterminada, coloca información sobre herramientas después de su elemento desencadenante.

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

$('#example').tooltip(options)

Margen

El marcado requerido para una información sobre herramientas es solo un dataatributo y titleen el elemento HTML que desea tener una información sobre herramientas. El marcado generado de una información sobre herramientas es bastante simple, aunque requiere una posición (de forma predeterminada, establecida toppor el complemento).

<!-- HTML to write -->
<a href="#" data-toggle="tooltip" title="Some tooltip text!">Hover over me</a>

<!-- Generated markup by the plugin -->
<div class="tooltip top" role="tooltip">
  <div class="tooltip-arrow"></div>
  <div class="tooltip-inner">
    Some tooltip text!
  </div>
</div>

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

Métodos

$().tooltip(options)

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

.tooltip('show')

Revela la información sobre herramientas de un elemento. Vuelve a la persona que llama antes de que se muestre la información sobre herramientas (es decir, antes de shown.bs.tooltipque ocurra el evento). Esto se considera una activación "manual" de la información sobre herramientas. La información sobre herramientas con títulos de longitud cero nunca se muestra.

$('#element').tooltip('show')

.tooltip('hide')

Oculta la información sobre herramientas de un elemento. Vuelve a la persona que llama antes de que la información sobre herramientas se haya ocultado (es decir, antes de hidden.bs.tooltipque ocurra el evento). Esto se considera una activación "manual" de la información sobre herramientas.

$('#element').tooltip('hide')

.tooltip('toggle')

Alterna la información sobre herramientas de un elemento. Vuelve a la persona que llama antes de que se muestre u oculte la información sobre herramientas (es decir, antes de que ocurra el evento shown.bs.tooltipo ). hidden.bs.tooltipEsto se considera una activación "manual" de la información sobre herramientas.

$('#element').tooltip('toggle')

.tooltip('destroy')

Oculta y destruye la información sobre herramientas de un elemento. La información sobre herramientas que utiliza la delegación (que se crea con la selectoropción ) no se puede destruir individualmente en los elementos desencadenantes descendientes.

$('#element').tooltip('destroy')

Eventos

$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something…
})

Popover popover.js

Agregue pequeñas superposiciones de contenido, como las del iPad, a cualquier elemento para albergar información secundaria.

Los popovers cuyo título y contenido tienen una longitud cero nunca se muestran.

$(function () {
  $('[data-toggle="popover"]').popover()
})

Ejemplos

ventana emergente estática

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

Demo en vivo

<button type="button" class="btn btn-lg btn-danger" data-toggle="popover" title="Popover title" data-content="And here's some amazing content. It's very engaging. Right?">Click to toggle popover</button>

cuatro direcciones

<button type="button" class="btn btn-default" data-container="body" data-toggle="popover" data-placement="left" data-content="Vivamus sagittis lacus vel augue laoreet rutrum faucibus.">
  Popover on left
</button>

<button type="button" class="btn btn-default" data-container="body" data-toggle="popover" data-placement="top" data-content="Vivamus sagittis lacus vel augue laoreet rutrum faucibus.">
  Popover on top
</button>

<button type="button" class="btn btn-default" data-container="body" data-toggle="popover" data-placement="bottom" data-content="Vivamus
sagittis lacus vel augue laoreet rutrum faucibus.">
  Popover on bottom
</button>

<button type="button" class="btn btn-default" data-container="body" data-toggle="popover" data-placement="right" data-content="Vivamus sagittis lacus vel augue laoreet rutrum faucibus.">
  Popover on right
</button>

Descartar en el siguiente clic

Use el focusdisparador para descartar popovers en el próximo clic que haga el usuario.

<a tabindex="0" class="btn btn-lg btn-danger" role="button" data-toggle="popover" data-trigger="focus" title="Dismissible popover" data-content="And here's some amazing content. It's very engaging. Right?">Dismissible popover</a>

Uso

Habilitar ventanas emergentes a través de JavaScript:

$('#example').popover(options)

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

Métodos

$().popover(options)

Inicializa popovers para una colección de elementos.

.popover('show')

Revela el popover de un elemento. Vuelve a la persona que llama antes de que se haya mostrado realmente el popover (es decir, antes de shown.bs.popoverque ocurra el evento). Esto se considera una activación "manual" del popover. Los popovers cuyo título y contenido tienen una longitud cero nunca se muestran.

$('#element').popover('show')

.popover('hide')

Oculta el popover de un elemento. Vuelve a la persona que llama antes de que se haya ocultado el popover (es decir, antes de hidden.bs.popoverque ocurra el evento). Esto se considera una activación "manual" del popover.

$('#element').popover('hide')

.popover('toggle')

Alterna el popover de un elemento. Vuelve a la persona que llama antes de que se muestre u oculte el popover (es decir, antes de que ocurra el evento shown.bs.popovero ). hidden.bs.popoverEsto se considera una activación "manual" del popover.

$('#element').popover('toggle')

.popover('destroy')

Oculta y destruye el popover de un elemento. Los popovers que usan delegación (que se crean usando la selectoropción ) no se pueden destruir individualmente en elementos desencadenantes descendientes.

$('#element').popover('destroy')

Eventos

$('#myPopover').on('hidden.bs.popover', function () {
  // do something…
})

Mensajes de alerta alert.js

Alertas de ejemplo

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

Al usar un .closebotón, debe ser el primer elemento secundario de .alert-dismissibley ningún contenido de texto puede aparecer antes que él en el marcado.

Uso

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

<button type="button" class="close" data-dismiss="alert" aria-label="Close">
  <span aria-hidden="true">&times;</span>
</button>

Para que sus alertas usen animación al cerrar, asegúrese de que ya tengan aplicadas las clases .fadey ..in

Métodos

$().alert()

Hace que una alerta escuche eventos de clic en elementos descendientes que tienen el data-dismiss="alert"atributo. (No es necesario cuando se usa la inicialización automática de la API de datos).

$().alert('close')

Cierra una alerta eliminándola del DOM. Si las clases .fadey .inestán presentes en el elemento, la alerta desaparecerá antes de que se elimine.

Eventos

El complemento de alerta de Bootstrap expone algunos eventos para conectarse a la funcionalidad de alerta.

$('#myAlert').on('closed.bs.alert', function () {
  // do something…
})

Botones boton.js

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.

Esta característica está obsoleta desde la versión 3.3.5 y se eliminó en la versión 4.

<button type="button" id="myButton" data-loading-text="Loading..." class="btn btn-primary">
  Loading state
</button>

<script>
  $('#myButton').on('click', function () {
    var $btn = $(this).button('loading')
    // business logic...
    $btn.button('reset')
  })
</script>

Cambio único

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

<button type="button" class="btn btn-primary" data-toggle="button" aria-pressed="false">
  Single toggle
</button>

Casilla de verificación / Radio

Agregue data-toggle="buttons"a una .btn-groupcasilla de verificación contenedora o entradas de radio para habilitar la alternancia en sus respectivos estilos.

<div class="btn-group" data-toggle="buttons">
  <label class="btn btn-primary active">
    <input type="checkbox" checked> Checkbox 1 (pre-checked)
  </label>
  <label class="btn btn-primary">
    <input type="checkbox"> Checkbox 2
  </label>
  <label class="btn btn-primary">
    <input type="checkbox"> Checkbox 3
  </label>
</div>

<div class="btn-group" data-toggle="buttons">
  <label class="btn btn-primary active">
    <input type="radio" name="options" id="option1" checked> Radio 1 (preselected)
  </label>
  <label class="btn btn-primary">
    <input type="radio" name="options" id="option2"> Radio 2
  </label>
  <label class="btn btn-primary">
    <input type="radio" name="options" id="option3"> Radio 3
  </label>
</div>

Métodos

$().button('toggle')

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

$().button('reset')

Restablece el estado del botón: cambia el texto al texto original. Este método es asíncrono y regresa antes de que se haya completado realmente el restablecimiento.

$().button(string)

Cambia el texto a cualquier estado de texto definido por datos.

<button type="button" id="myStateButton" data-complete-text="finished!" class="btn btn-primary">
  ...
</button>

<script>
  $('#myStateButton').on('click', function () {
    $(this).button('complete') // button text will be "finished!"
  })
</script>

Contraer colapso.js

Complemento flexible que utiliza un puñado de clases para un comportamiento de alternancia fácil.

Ejemplo

Haga clic en los botones de abajo para mostrar y ocultar otro elemento a través de cambios de clase:

• .collapseoculta contenido
• .collapsingse aplica durante las transiciones
• .collapse.inmuestra contenido

Puede usar un enlace con el hrefatributo o un botón con el data-targetatributo. En ambos casos, data-toggle="collapse"se requiere el.

<a class="btn btn-primary" role="button" data-toggle="collapse" href="#collapseExample" aria-expanded="false" aria-controls="collapseExample">
  Link with href
</a>
<button class="btn btn-primary" type="button" data-toggle="collapse" data-target="#collapseExample" aria-expanded="false" aria-controls="collapseExample">
  Button with data-target
</button>
<div class="collapse" id="collapseExample">
  <div class="well">
    ...
  </div>
</div>

Ejemplo de acordeón

Extienda el comportamiento de contracción predeterminado para crear un acordeón con el componente del panel.

<div class="panel-group" id="accordion" role="tablist" aria-multiselectable="true">
  <div class="panel panel-default">
    <div class="panel-heading" role="tab" id="headingOne">
      <h4 class="panel-title">
        <a role="button" data-toggle="collapse" data-parent="#accordion" href="#collapseOne" aria-expanded="true" aria-controls="collapseOne">
          Collapsible Group Item #1
        </a>
      </h4>
    </div>
    <div id="collapseOne" class="panel-collapse collapse in" role="tabpanel" aria-labelledby="headingOne">
      <div class="panel-body">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
      </div>
    </div>
  </div>
  <div class="panel panel-default">
    <div class="panel-heading" role="tab" id="headingTwo">
      <h4 class="panel-title">
        <a class="collapsed" role="button" data-toggle="collapse" data-parent="#accordion" href="#collapseTwo" aria-expanded="false" aria-controls="collapseTwo">
          Collapsible Group Item #2
        </a>
      </h4>
    </div>
    <div id="collapseTwo" class="panel-collapse collapse" role="tabpanel" aria-labelledby="headingTwo">
      <div class="panel-body">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
      </div>
    </div>
  </div>
  <div class="panel panel-default">
    <div class="panel-heading" role="tab" id="headingThree">
      <h4 class="panel-title">
        <a class="collapsed" role="button" data-toggle="collapse" data-parent="#accordion" href="#collapseThree" aria-expanded="false" aria-controls="collapseThree">
          Collapsible Group Item #3
        </a>
      </h4>
    </div>
    <div id="collapseThree" class="panel-collapse collapse" role="tabpanel" aria-labelledby="headingThree">
      <div class="panel-body">
        Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS.
      </div>
    </div>
  </div>
</div>

También es posible intercambiar .panel-bodys con .list-groups.

Uso

El complemento de colapso utiliza algunas clases para manejar el trabajo pesado:

• .collapseoculta el contenido
• .collapse.inmuestra el contenido
• .collapsingse agrega cuando comienza la transición y se elimina cuando finaliza

Estas clases se pueden encontrar en component-animations.less.

A través de atributos de datos

Simplemente agregue data-toggle="collapse"y data-targetal elemento para asignar automáticamente el control de un elemento contraíble. El data-targetatributo acepta un selector de 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:

$('.collapse').collapse()

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

Métodos

.collapse(options)

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

$('#myCollapsible').collapse({
  toggle: false
})

.collapse('toggle')

Cambia un elemento colapsable a mostrado u oculto. Vuelve a la persona que llama antes de que el elemento contraíble se haya mostrado u ocultado (es decir, antes de que ocurra el evento shown.bs.collapseo ).hidden.bs.collapse

.collapse('show')

Muestra un elemento plegable. Vuelve a la persona que llama antes de que se haya mostrado realmente el elemento colapsable (es decir, antes de shown.bs.collapseque ocurra el evento).

.collapse('hide')

Oculta un elemento contraíble. Vuelve a la persona que llama antes de que el elemento contraíble se haya ocultado (es decir, antes de hidden.bs.collapseque ocurra el evento).

Eventos

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

$('#myCollapsible').on('hidden.bs.collapse', function () {
  // do something…
})

Carrusel carrusel.js

Un componente de presentación de diapositivas para recorrer los elementos, como un carrusel. Los carruseles anidados no son compatibles.

Ejemplos

Anterior próximo

<div id="carousel-example-generic" class="carousel slide" data-ride="carousel">
  <!-- Indicators -->
  <ol class="carousel-indicators">
    <li data-target="#carousel-example-generic" data-slide-to="0" class="active"></li>
    <li data-target="#carousel-example-generic" data-slide-to="1"></li>
    <li data-target="#carousel-example-generic" data-slide-to="2"></li>
  </ol>

  <!-- Wrapper for slides -->
  <div class="carousel-inner" role="listbox">
    <div class="item active">
      <img src="..." alt="...">
      <div class="carousel-caption">
        ...
      </div>
    </div>
    <div class="item">
      <img src="..." alt="...">
      <div class="carousel-caption">
        ...
      </div>
    </div>
    ...
  </div>

  <!-- Controls -->
  <a class="left carousel-control" href="#carousel-example-generic" role="button" data-slide="prev">
    <span class="glyphicon glyphicon-chevron-left" aria-hidden="true"></span>
    <span class="sr-only">Previous</span>
  </a>
  <a class="right carousel-control" href="#carousel-example-generic" role="button" data-slide="next">
    <span class="glyphicon glyphicon-chevron-right" aria-hidden="true"></span>
    <span class="sr-only">Next</span>
  </a>
</div>

Subtítulos opcionales

Agregue subtítulos a sus diapositivas fácilmente con el .carousel-captionelemento dentro de cualquier archivo .item. Coloque casi cualquier HTML opcional allí y se alineará y formateará automáticamente.

Etiqueta de la primera diapositiva

Nulla vitae elit libero, un pharetra augue mollis interdum.

Etiqueta de la segunda diapositiva

Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Etiqueta de la tercera diapositiva

Praesent commodo cursus magna, vel scelerisque nisl consectetur.

Anterior próximo

<div class="item">
  <img src="..." alt="...">
  <div class="carousel-caption">
    <h3>...</h3>
    <p>...</p>
  </div>
</div>

Uso

Múltiples carruseles

Los carruseles requieren el uso de un iden el contenedor más externo (el .carousel) para que los controles del carrusel funcionen correctamente. Al agregar varios carruseles, o al cambiar un carrusel id, asegúrese de actualizar los controles relevantes.

A través de atributos de datos

Utilice atributos de datos para controlar fácilmente la posición del carrusel. data-slideacepta las palabras clave prevo next, que altera la posición de la diapositiva en relación con su posición actual. Alternativamente, use data-slide-topara pasar un índice de diapositiva sin procesar al carrusel data-slide-to="2", que cambia la posición de la diapositiva a un índice particular que comienza con 0.

El data-ride="carousel"atributo se usa para marcar un carrusel como animado a partir de la carga de la página. No se puede usar en combinación con la inicialización explícita de JavaScript (redundante e innecesaria) del mismo carrusel.

A través de JavaScript

Carrusel de llamadas manualmente con:

$('.carousel').carousel()

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

Métodos

.carousel(options)

Inicializa el carrusel con opciones opcionales objecty comienza a recorrer los elementos.

$('.carousel').carousel({
  interval: 2000
})

.carousel('cycle')

Recorre los elementos del carrusel de izquierda a derecha.

.carousel('pause')

Evita que el carrusel pase de un elemento a otro.

.carousel(number)

Cicla el carrusel a un marco en particular (basado en 0, similar a una matriz).

.carousel('prev')

Pasa al elemento anterior.

.carousel('next')

Pasa al elemento siguiente.

Eventos

La clase de carrusel de Bootstrap expone dos eventos para conectarse a la funcionalidad del carrusel.

Ambos eventos tienen las siguientes propiedades adicionales:

• direction: La dirección en la que se desliza el carrusel (ya sea "left"o "right").
• relatedTarget: El elemento DOM que se desliza en su lugar como el elemento activo.

Todos los eventos del carrusel se activan en el propio carrusel (es decir, en el <div class="carousel">).

$('#myCarousel').on('slide.bs.carousel', function () {
  // do something…
})

Afijo afijo.js

Ejemplo

El complemento de afijo se activa position: fixed;y desactiva, emulando el efecto encontrado con position: sticky;. La subnavegación a la derecha es una demostración en vivo del complemento de afijo.

Uso

Use el complemento de afijo a través de atributos de datos o manualmente con su propio JavaScript. En ambas situaciones, debe proporcionar CSS para el posicionamiento y el ancho de su contenido adjunto.

Nota: No use el complemento de afijo en un elemento contenido en un elemento posicionado relativamente, como una columna empujada o empujada, debido a un error de representación de Safari .

Posicionamiento vía CSS

El complemento de afijo alterna entre tres clases, cada una de las cuales representa un estado particular: .affix, .affix-topy .affix-bottom. Debe proporcionar los estilos, con la excepción de position: fixed;on .affix, para estas clases usted mismo (independientemente de este complemento) para manejar las posiciones reales.

Así es como funciona el complemento de afijo:

1. Para comenzar, el complemento agrega.affix-top para indicar que el elemento está en su posición más alta. En este punto no se requiere posicionamiento CSS.
2. Desplazarse más allá del elemento que desea colocar debería activar la fijación real. Aquí es donde .affixreemplaza .affix-topy establece position: fixed;(proporcionado por el CSS de Bootstrap).
3. Si se define un desplazamiento inferior, el desplazamiento más allá debería reemplazarse .affixcon .affix-bottom. Dado que las compensaciones son opcionales, configurar uno requiere que configure el CSS apropiado. En este caso, agregue position: absolute;cuando sea necesario. El complemento utiliza el atributo de datos o la opción de JavaScript para determinar dónde colocar el elemento desde allí.

Siga los pasos anteriores para configurar su CSS para cualquiera de las siguientes opciones de 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. Use compensaciones para definir cuándo alternar la fijación de un elemento.

<div data-spy="affix" data-offset-top="60" data-offset-bottom="200">
  ...
</div>

A través de JavaScript

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

$('#myAffix').affix({
  offset: {
    top: 100,
    bottom: function () {
      return (this.bottom = $('.footer').outerHeight(true))
    }
  }
})

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

Métodos

.affix(options)

Activa tu contenido como contenido adjunto. Acepta opciones opcionales object.

$('#myAffix').affix({
  offset: 15
})

.affix('checkPosition')

Vuelve a calcular el estado del afijo en función de las dimensiones, la posición y la posición de desplazamiento de los elementos relevantes. Las clases .affix, .affix-topy .affix-bottomse agregan o eliminan del contenido adjunto de acuerdo con el nuevo estado. Es necesario llamar a este método cada vez que se cambien las dimensiones del contenido adjunto o el elemento de destino, para garantizar el posicionamiento correcto del contenido adjunto.

$('#myAffix').affix('checkPosition')

Eventos

El complemento de afijo de Bootstrap expone algunos eventos para conectarse a la funcionalidad de afijo.