Skip to main content Skip to docs navigation

关闭按钮(Close button)

这是一个通用的关闭按钮(close button)组件,用于关闭诸如模态框(modal)和警告框(alert)之类的窗口。

On this page

示例

本组件通过 .btn-close 类提供了一个关闭其它组件的方式。默认样式不多,但可定制度高。通过修改 Sass 变量可替换默认的 background-image请务必为屏幕阅读器添加说明性文字,就像下面示例中的 aria-label 一样。

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

禁用状态

处于禁用状态的关闭按钮(close button)会改变自己的透明度 opacity 属性。我们还设置了 pointer-events: noneuser-select: none 来防止鼠标悬停和活动状态被触发。

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

Dark variant

Heads up! As of v5.3.0, the .btn-close-white class is deprecated. Instead, use data-bs-theme="dark" to change the color mode of the close button.

Add data-bs-theme="dark" to the .btn-close, or to its parent element, to invert the close button. This uses the filter property to invert the background-image without overriding its value.

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>

Sass

变量

$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.414z'/></svg>");
$btn-close-focus-shadow:     $input-btn-focus-box-shadow;
$btn-close-opacity:          .5;
$btn-close-hover-opacity:    .75;
$btn-close-focus-opacity:    1;
$btn-close-disabled-opacity: .25;
$btn-close-white-filter:     invert(1) grayscale(100%) brightness(200%);