Skip to main content Skip to docs navigation
Ver en GitHub

Botón de cierre

Un botón de cierre genérico para descartar contenido como modales y alertas.

En esta página

Ejemplo

Proporciona una opción para descartar o cerrar un componente con .btn-close. El estilo predeterminado es limitado, pero altamente ajustable. Modifica las variables Sass para reemplazar la background-image predeterminada. Asegúrate de incluir texto para lectores de pantalla, como hemos hecho con aria-label.

html 
<button type="button" class="btn-close" aria-label="Close"></button>

Estado deshabilitado

Los botones de cierre deshabilitados cambian su opacity. También hemos aplicado pointer-events: none y user-select: none para evitar que se activen los estados activo y de desplazamiento (hover).

html 
<button type="button" class="btn-close" disabled aria-label="Close"></button>

Variante oscura

Obsoleto en v5.3.0

¡Atención! A partir de v5.3.0, la clase .btn-close-white está obsoleta. En su lugar, utiliza data-bs-theme="dark" para cambiar el modo de color del botón de cierre.

Agrega data-bs-theme="dark" al .btn-close, o a su elemento padre, para invertir el botón de cierre. Esto utiliza la propiedad filter para invertir la background-image sin anular su valor.

html 
<div data-bs-theme="dark">
  <button type="button" class="btn-close" aria-label="Close"></button>
  <button type="button" class="btn-close" disabled aria-label="Close"></button>
</div>

CSS

Variables

Agregado en v5.3.0

Como parte del enfoque evolutivo de las variables CSS de Bootstrap, el botón de cierre ahora usa variables CSS locales en .btn-close para una personalización mejorada en tiempo real. Los valores de las variables CSS se establecen a través de Sass, por lo que la personalización de Sass también es compatible.

scss/_close.scss 
--#{$prefix}btn-close-color: #{$btn-close-color};
--#{$prefix}btn-close-bg: #{ escape-svg($btn-close-bg) };
--#{$prefix}btn-close-opacity: #{$btn-close-opacity};
--#{$prefix}btn-close-hover-opacity: #{$btn-close-hover-opacity};
--#{$prefix}btn-close-focus-shadow: #{$btn-close-focus-shadow};
--#{$prefix}btn-close-focus-opacity: #{$btn-close-focus-opacity};
--#{$prefix}btn-close-disabled-opacity: #{$btn-close-disabled-opacity};

Variables de Sass

scss/_variables.scss 
$btn-close-width:            1em;
$btn-close-height:           $btn-close-width;
$btn-close-padding-x:        .25em;
$btn-close-padding-y:        $btn-close-padding-x;
$btn-close-color:            $black;
$btn-close-bg:               url("data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='#{$btn-close-color}'><path d='M.293.293a1 1 0 0 1 1.414 0L8 6.586 14.293.293a1 1 0 1 1 1.414 1.414L9.414 8l6.293 6.293a1 1 0 0 1-1.414 1.414L8 9.414l-6.293 6.293a1 1 0 0 1-1.414-1.414L6.586 8 .293 1.707a1 1 0 0 1 0-1.414'/></svg>");
$btn-close-focus-shadow:     $focus-ring-box-shadow;
$btn-close-opacity:          .5;
$btn-close-hover-opacity:    .75;
$btn-close-focus-opacity:    1;
$btn-close-disabled-opacity: .25;
$btn-close-filter:           null;
$btn-close-white-filter:     invert(1) grayscale(100%) brightness(200%); // Deprecated in v5.3.4