Ver en GitHub

Modal

Usa el plugin de modal de JavaScript de Bootstrap para añadir diálogos a tu sitio para lightboxes, notificaciones de usuario o contenido completamente personalizado.

On this page

Cómo funciona

Antes de empezar con el componente modal de Bootstrap, asegúrate de leer lo siguiente ya que nuestras opciones de menú han cambiado recientemente.

Los modales se construyen con HTML, CSS y JavaScript. Se posicionan sobre todo lo demás en el documento y eliminan el scroll del <body> para que el contenido del modal haga scroll en su lugar.
Hacer clic en el “fondo” del modal cerrará automáticamente el modal.
Bootstrap solo soporta una ventana modal a la vez. Los modales anidados no están soportados ya que consideramos que son una mala experiencia de usuario.
Los modales usan position: fixed, lo que a veces puede ser un poco particular respecto a su renderizado. Siempre que sea posible, coloca el HTML de tu modal en una posición de nivel superior para evitar posibles interferencias de otros elementos. Probablemente encuentres problemas al anidar un .modal dentro de otro elemento fijo.
Una vez más, debido a position: fixed, hay algunas advertencias al usar modales en dispositivos móviles. Consulta nuestra documentación de soporte de navegadores para más detalles.
Debido a cómo HTML5 define su semántica, el atributo HTML autofocus no tiene efecto en los modales de Bootstrap. Para lograr el mismo efecto, usa algo de JavaScript personalizado:

var myModal = document.getElementById('myModal')
var myInput = document.getElementById('myInput')

myModal.addEventListener('shown.bs.modal', function () {
  myInput.focus()
})

El efecto de animación de este componente depende de la media query prefers-reduced-motion. Consulta la sección de movimiento reducido de nuestra documentación de accesibilidad.

Sigue leyendo para ver demos y guías de uso.

Ejemplos

A continuación se muestra un ejemplo de modal estático (lo que significa que su position y display han sido sobrescritos). Se incluyen el encabezado del modal, el cuerpo del modal (obligatorio para el padding) y el pie del modal (opcional). Te pedimos que incluyas encabezados de modal con acciones de cierre siempre que sea posible, o que proporciones otra acción de cierre explícita.

<div class="modal" tabindex="-1">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title">Modal title</h5>
        <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
      </div>
      <div class="modal-body">
        <p>Modal body text goes here.</p>
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div>
  </div>
</div>

Demo en vivo

Activa una demo funcional de un modal haciendo clic en el botón de abajo. Se deslizará hacia abajo y aparecerá con un desvanecimiento desde la parte superior de la página.

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

<!-- Modal -->
<div class="modal fade" id="exampleModal" tabindex="-1" aria-labelledby="exampleModalLabel" aria-hidden="true">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title" id="exampleModalLabel">Modal title</h5>
        <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
      </div>
      <div class="modal-body">
        ...
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Save changes</button>
      </div>
    </div>
  </div>
</div>

Fondo estático

Cuando el fondo se establece como estático, el modal no se cerrará al hacer clic fuera de él. Haz clic en el botón de abajo para probarlo.

<!-- Button trigger modal -->
<button type="button" class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#staticBackdrop">
  Launch static backdrop modal
</button>

<!-- Modal -->
<div class="modal fade" id="staticBackdrop" data-bs-backdrop="static" data-bs-keyboard="false" tabindex="-1" aria-labelledby="staticBackdropLabel" aria-hidden="true">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title" id="staticBackdropLabel">Modal title</h5>
        <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
      </div>
      <div class="modal-body">
        ...
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Understood</button>
      </div>
    </div>
  </div>
</div>

Scroll de contenido largo

Cuando los modales son demasiado largos para el viewport o dispositivo del usuario, se desplazan de forma independiente a la página. Prueba la demo de abajo para ver a qué nos referimos.

También puedes crear un modal con scroll que permita desplazar el cuerpo del modal añadiendo .modal-dialog-scrollable a .modal-dialog.

<!-- Scrollable modal -->
<div class="modal-dialog modal-dialog-scrollable">
  ...
</div>

Centrado verticalmente

Añade .modal-dialog-centered a .modal-dialog para centrar verticalmente el modal.

<!-- Vertically centered modal -->
<div class="modal-dialog modal-dialog-centered">
  ...
</div>

<!-- Vertically centered scrollable modal -->
<div class="modal-dialog modal-dialog-centered modal-dialog-scrollable">
  ...
</div>

Tooltips y popovers

Los tooltips y los popovers se pueden colocar dentro de los modales según sea necesario. Cuando se cierran los modales, cualquier tooltip y popover dentro de ellos también se cierran automáticamente.

<div class="modal-body">
  <h5>Popover in a modal</h5>
  <p>This <a href="#" role="button" class="btn btn-secondary popover-test" title="Popover title" data-bs-content="Popover body content is set in this attribute.">button</a> triggers a popover on click.</p>
  <hr>
  <h5>Tooltips in a modal</h5>
  <p><a href="#" class="tooltip-test" title="Tooltip">This link</a> and <a href="#" class="tooltip-test" title="Tooltip">that link</a> have tooltips on hover.</p>
</div>

Uso de la grilla

Utiliza el sistema de grilla de Bootstrap dentro de un modal anidando .container-fluid dentro del .modal-body. Luego, usa las clases normales del sistema de grilla como lo harías en cualquier otro lugar.

<div class="modal-body">
  <div class="container-fluid">
    <div class="row">
      <div class="col-md-4">.col-md-4</div>
      <div class="col-md-4 ms-auto">.col-md-4 .ms-auto</div>
    </div>
    <div class="row">
      <div class="col-md-3 ms-auto">.col-md-3 .ms-auto</div>
      <div class="col-md-2 ms-auto">.col-md-2 .ms-auto</div>
    </div>
    <div class="row">
      <div class="col-md-6 ms-auto">.col-md-6 .ms-auto</div>
    </div>
    <div class="row">
      <div class="col-sm-9">
        Level 1: .col-sm-9
        <div class="row">
          <div class="col-8 col-sm-6">
            Level 2: .col-8 .col-sm-6
          </div>
          <div class="col-4 col-sm-6">
            Level 2: .col-4 .col-sm-6
          </div>
        </div>
      </div>
    </div>
  </div>
</div>

¿Tienes un conjunto de botones que activan el mismo modal con contenidos ligeramente diferentes? Usa event.relatedTarget y los atributos HTML data-bs-* para variar el contenido del modal dependiendo de en qué botón se haya hecho clic.

A continuación se muestra una demo en vivo seguida de HTML y JavaScript de ejemplo. Para más información, lee la documentación de eventos del modal para más detalles sobre relatedTarget.

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

<div class="modal fade" id="exampleModal" tabindex="-1" aria-labelledby="exampleModalLabel" aria-hidden="true">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title" id="exampleModalLabel">New message</h5>
        <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
      </div>
      <div class="modal-body">
        <form>
          <div class="mb-3">
            <label for="recipient-name" class="col-form-label">Recipient:</label>
            <input type="text" class="form-control" id="recipient-name">
          </div>
          <div class="mb-3">
            <label for="message-text" class="col-form-label">Message:</label>
            <textarea class="form-control" id="message-text"></textarea>
          </div>
        </form>
      </div>
      <div class="modal-footer">
        <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Close</button>
        <button type="button" class="btn btn-primary">Send message</button>
      </div>
    </div>
  </div>
</div>

var exampleModal = document.getElementById('exampleModal')
exampleModal.addEventListener('show.bs.modal', function (event) {
  // Button that triggered the modal
  var button = event.relatedTarget
  // Extract info from data-bs-* attributes
  var recipient = button.getAttribute('data-bs-whatever')
  // If necessary, you could initiate an AJAX request here
  // and then do the updating in a callback.
  //
  // Update the modal's content.
  var modalTitle = exampleModal.querySelector('.modal-title')
  var modalBodyInput = exampleModal.querySelector('.modal-body input')

  modalTitle.textContent = 'New message to ' + recipient
  modalBodyInput.value = recipient
})

Alternar entre modales

Alterna entre múltiples modales con una colocación inteligente de los atributos data-bs-target y data-bs-toggle. Por ejemplo, podrías alternar un modal de restablecimiento de contraseña desde dentro de un modal de inicio de sesión ya abierto. Ten en cuenta que no se pueden tener múltiples modales abiertos al mismo tiempo—este método simplemente alterna entre dos modales separados.

Abrir primer modal

<div class="modal fade" id="exampleModalToggle" aria-hidden="true" aria-labelledby="exampleModalToggleLabel" tabindex="-1">
  <div class="modal-dialog modal-dialog-centered">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title" id="exampleModalToggleLabel">Modal 1</h5>
        <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
      </div>
      <div class="modal-body">
        Show a second modal and hide this one with the button below.
      </div>
      <div class="modal-footer">
        <button class="btn btn-primary" data-bs-target="#exampleModalToggle2" data-bs-toggle="modal" data-bs-dismiss="modal">Open second modal</button>
      </div>
    </div>
  </div>
</div>
<div class="modal fade" id="exampleModalToggle2" aria-hidden="true" aria-labelledby="exampleModalToggleLabel2" tabindex="-1">
  <div class="modal-dialog modal-dialog-centered">
    <div class="modal-content">
      <div class="modal-header">
        <h5 class="modal-title" id="exampleModalToggleLabel2">Modal 2</h5>
        <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
      </div>
      <div class="modal-body">
        Hide this modal and show the first with the button below.
      </div>
      <div class="modal-footer">
        <button class="btn btn-primary" data-bs-target="#exampleModalToggle" data-bs-toggle="modal" data-bs-dismiss="modal">Back to first</button>
      </div>
    </div>
  </div>
</div>
<a class="btn btn-primary" data-bs-toggle="modal" href="#exampleModalToggle" role="button">Open first modal</a>

Cambiar la animación

La variable $modal-fade-transform determina el estado de transformación de .modal-dialog antes de la animación de desvanecimiento del modal, la variable $modal-show-transform determina la transformación de .modal-dialog al final de la animación de desvanecimiento del modal.

Si quieres por ejemplo una animación de zoom, puedes establecer $modal-fade-transform: scale(.8).

Eliminar la animación

Para modales que simplemente aparecen en lugar de desvanecerse a la vista, elimina la clase .fade de tu marcado modal.

<div class="modal" tabindex="-1" aria-labelledby="..." aria-hidden="true">
  ...
</div>

Alturas dinámicas

Si la altura de un modal cambia mientras está abierto, deberías llamar a myModal.handleUpdate() para reajustar la posición del modal en caso de que aparezca una barra de scroll.

Accesibilidad

Asegúrate de añadir aria-labelledby="...", haciendo referencia al título del modal, a .modal. Además, puedes dar una descripción de tu diálogo modal con aria-describedby en .modal. Ten en cuenta que no necesitas añadir role="dialog" ya que lo añadimos vía JavaScript.

Incrustación de videos de YouTube

Incrustar videos de YouTube en modales requiere JavaScript adicional que no está en Bootstrap para detener automáticamente la reproducción y más. Consulta este útil post de Stack Overflow para más información.

Tamaños opcionales

Los modales tienen tres tamaños opcionales, disponibles mediante clases modificadoras que se colocan en un .modal-dialog. Estos tamaños entran en acción en ciertos breakpoints para evitar barras de scroll horizontales en viewports más estrechos.

Tamaño	Clase	Ancho máximo del modal
Pequeño	`.modal-sm`	`300px`
Predeterminado	Ninguno	`500px`
Grande	`.modal-lg`	`800px`
Extra grande	`.modal-xl`	`1140px`

Nuestro modal predeterminado sin clase modificadora constituye el modal de tamaño “medio”.

<div class="modal-dialog modal-xl">...</div>
<div class="modal-dialog modal-lg">...</div>
<div class="modal-dialog modal-sm">...</div>

Otra posibilidad es la opción de mostrar un modal que cubre el viewport del usuario, disponible mediante clases modificadoras que se colocan en un .modal-dialog.

Clase	Disponibilidad
`.modal-fullscreen`	Siempre
`.modal-fullscreen-sm-down`	Por debajo de `576px`
`.modal-fullscreen-md-down`	Por debajo de `768px`
`.modal-fullscreen-lg-down`	Por debajo de `992px`
`.modal-fullscreen-xl-down`	Por debajo de `1200px`
`.modal-fullscreen-xxl-down`	Por debajo de `1400px`

<!-- Full screen modal -->
<div class="modal-dialog modal-fullscreen-sm-down">
  ...
</div>

Sass

Variables

$modal-inner-padding:               $spacer;

$modal-footer-margin-between:       .5rem;

$modal-dialog-margin:               .5rem;
$modal-dialog-margin-y-sm-up:       1.75rem;

$modal-title-line-height:           $line-height-base;

$modal-content-color:               null;
$modal-content-bg:                  $white;
$modal-content-border-color:        rgba($black, .2);
$modal-content-border-width:        $border-width;
$modal-content-border-radius:       $border-radius-lg;
$modal-content-inner-border-radius: subtract($modal-content-border-radius, $modal-content-border-width);
$modal-content-box-shadow-xs:       $box-shadow-sm;
$modal-content-box-shadow-sm-up:    $box-shadow;

$modal-backdrop-bg:                 $black;
$modal-backdrop-opacity:            .5;
$modal-header-border-color:         $border-color;
$modal-footer-border-color:         $modal-header-border-color;
$modal-header-border-width:         $modal-content-border-width;
$modal-footer-border-width:         $modal-header-border-width;
$modal-header-padding-y:            $modal-inner-padding;
$modal-header-padding-x:            $modal-inner-padding;
$modal-header-padding:              $modal-header-padding-y $modal-header-padding-x; // Keep this for backwards compatibility

$modal-sm:                          300px;
$modal-md:                          500px;
$modal-lg:                          800px;
$modal-xl:                          1140px;

$modal-fade-transform:              translate(0, -50px);
$modal-show-transform:              none;
$modal-transition:                  transform .3s ease-out;
$modal-scale-transform:             scale(1.02);

Loop

Los modales responsive a pantalla completa se generan mediante el mapa $breakpoints y un bucle en scss/_modal.scss.

@each $breakpoint in map-keys($grid-breakpoints) {
  $infix: breakpoint-infix($breakpoint, $grid-breakpoints);
  $postfix: if($infix != "", $infix + "-down", "");

  @include media-breakpoint-down($breakpoint) {
    .modal-fullscreen#{$postfix} {
      width: 100vw;
      max-width: none;
      height: 100%;
      margin: 0;

      .modal-content {
        height: 100%;
        border: 0;
        @include border-radius(0);
      }

      .modal-header {
        @include border-radius(0);
      }

      .modal-body {
        overflow-y: auto;
      }

      .modal-footer {
        @include border-radius(0);
      }
    }
  }
}

Uso

El plugin modal alterna tu contenido oculto bajo demanda, vía atributos data o JavaScript. También sobrescribe el comportamiento de scroll predeterminado y genera un .modal-backdrop para proporcionar un área de clic para cerrar los modales mostrados al hacer clic fuera del modal.

A través de atributos data

Activa un modal sin escribir JavaScript. Establece data-bs-toggle="modal" en un elemento controlador, como un botón, junto con un data-bs-target="#foo" o href="#foo" para apuntar a un modal específico a alternar.

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

A través de JavaScript

Crea un modal con una sola línea de JavaScript:

var myModal = new bootstrap.Modal(document.getElementById('myModal'), options)

Opciones

Las opciones se pueden pasar vía atributos data o JavaScript. Para los atributos data, añade el nombre de la opción a data-bs-, como en data-bs-backdrop="".

Nombre	Tipo	Predeterminado	Descripción
`backdrop`	booleano o el string `'static'`	`true`	Incluye un elemento modal-backdrop. Alternativamente, especifica `static` para un fondo que no cierra el modal al hacer clic.
`keyboard`	boolean	`true`	Cierra el modal cuando se pulsa la tecla escape
`focus`	boolean	`true`	Pone el foco en el modal al inicializarlo.

Métodos

Métodos asíncronos y transiciones

Todos los métodos de la API son asíncronos e inician una transición. Vuelven al llamador tan pronto como se inicia la transición pero antes de que termine. Además, una llamada a un método en un componente en transición será ignorada.

Consulta nuestra documentación de JavaScript para más información.

Pasar opciones

Activa tu contenido como un modal. Acepta un objeto de opciones opcional.

var myModal = new bootstrap.Modal(document.getElementById('myModal'), {
  keyboard: false
})

toggle

Alterna manualmente un modal. Retorna al llamador antes de que el modal se haya mostrado u ocultado realmente (es decir, antes de que ocurra el evento shown.bs.modal o hidden.bs.modal).

myModal.toggle()

show

Abre manualmente un modal. Retorna al llamador antes de que el modal se haya mostrado realmente (es decir, antes de que ocurra el evento shown.bs.modal).

myModal.show()

Además, puedes pasar un elemento del DOM como argumento que puede ser recibido en los eventos del modal (como la propiedad relatedTarget).

var modalToggle = document.getElementById('toggleMyModal') // relatedTarget
myModal.show(modalToggle)

hide

Oculta manualmente un modal. Retorna al llamador antes de que el modal se haya ocultado realmente (es decir, antes de que ocurra el evento hidden.bs.modal).

myModal.hide()

handleUpdate

Reajusta manualmente la posición del modal si la altura de un modal cambia mientras está abierto (es decir, en caso de que aparezca una barra de scroll).

myModal.handleUpdate()

dispose

Destruye el modal de un elemento. (Elimina los datos almacenados en el elemento del DOM)

myModal.dispose()

getInstance

Método estático que te permite obtener la instancia del modal asociada a un elemento del DOM

var myModalEl = document.getElementById('myModal')
var modal = bootstrap.Modal.getInstance(myModalEl) // Returns a Bootstrap modal instance

getOrCreateInstance

Método estático que te permite obtener la instancia del modal asociada a un elemento del DOM, o crear una nueva en caso de que no haya sido inicializada

var myModalEl = document.querySelector('#myModal')
var modal = bootstrap.Modal.getOrCreateInstance(myModalEl) // Returns a Bootstrap modal instance

Eventos

La clase modal de Bootstrap expone algunos eventos para conectarse a la funcionalidad del modal. Todos los eventos del modal se disparan en el propio modal (es decir, en el <div class="modal">).

Tipo de evento	Descripción
`show.bs.modal`	Este evento se dispara inmediatamente cuando se llama al método de instancia `show`. Si es causado por un clic, el elemento clickeado está disponible como la propiedad `relatedTarget` del evento.
`shown.bs.modal`	Este evento se dispara cuando el modal se ha hecho visible al usuario (esperará a que se completen las transiciones CSS). Si es causado por un clic, el elemento clickeado está disponible como la propiedad `relatedTarget` del evento.
`hide.bs.modal`	Este evento se dispara inmediatamente cuando se ha llamado al método de instancia `hide`.
`hidden.bs.modal`	Este evento se dispara cuando el modal ha terminado de ocultarse al usuario (esperará a que se completen las transiciones CSS).
`hidePrevented.bs.modal`	Este evento se dispara cuando el modal se muestra, su fondo es `static` y se realiza un clic fuera del modal o se pulsa la tecla escape con la opción keyboard o `data-bs-keyboard` establecida en `false`.

var myModalEl = document.getElementById('myModal')
myModalEl.addEventListener('hidden.bs.modal', function (event) {
  // do something...
})