Bootstrap V5.3 中文手册

Close button 关闭按钮

用于关闭模式和警报等内容的通用关闭按钮。

提供一个选项来关闭或关闭组件 。默认样式是有限的,但高度可定制。修改 Sass 变量以替换默认的 。请务必包含屏幕阅读器的文本,就像我们使用 ..btn-closebackground-imagearia-label

[HTML全文]
<button type="button" class="btn-close" aria-label="Close"></button>

禁用状态

禁用的关闭按钮会更改其 .我们还应用了 和 来防止触发悬停和活动状态。opacitypointer-events: noneuser-select: none

[HTML全文]
<button type="button" class="btn-close" disabled aria-label="Close"></button>

深色变体

在 v5.3.0 中已弃用

小心! 从 v5.3.0 开始,该类已被弃用。相反,请使用 来更改关闭按钮的颜色模式。.btn-close-whitedata-bs-theme="dark"

添加到 或其父元素以反转关闭按钮。这使用该属性来反转 而不覆盖其值。data-bs-theme="dark".btn-closefilterbackground-image

[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系统

变量

在 v5.3.0 中添加

作为 Bootstrap 不断发展的 CSS 变量方法的一部分,关闭按钮现在使用本地 CSS 变量来增强实时自定义。CSS 变量的值是通过 Sass 设置的,因此仍然支持 Sass 自定义。.btn-close

--#{$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};

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