關閉按鈕

用於關閉內容（例如對話框和警示）的一般關閉按鈕。

在此頁面上

範例

使用 .btn-close 提供關閉或關閉元件的選項。預設樣式有限，但高度可自訂。修改 Sass 變數以取代預設的 background-image。務必包含螢幕閱讀器的文字，就像我們使用 aria-label 所做的那樣。

html

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

已停用狀態

停用的關閉按鈕會變更其 opacity。我們也套用 pointer-events: none 和 user-select: none 來防止觸發游標移入和作用中狀態。

html

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

深色變體

已於 v5.3.0 中棄用

注意！自 v5.3.0 起，.btn-close-white 類別已棄用。請改用 data-bs-theme="dark" 來變更關閉按鈕的色彩模式。

將 data-bs-theme="dark" 加入 .btn-close 或其父元素，以反轉關閉按鈕。這會使用 filter 屬性來反轉 background-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 變數方法的一部分，關閉按鈕現在在 .btn-close 上使用本機 CSS 變數，以增強即時自訂。CSS 變數的值是透過 Sass 設定，因此 Sass 自訂仍受支援。

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};
--#{$prefix}btn-close-white-filter: #{$btn-close-white-filter};

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.414z'/></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-white-filter:     invert(1) grayscale(100%) brightness(200%);