閉じるボタン

モーダルやアラートなどのコンテンツを閉じるための汎用的な閉じるボタンです。

このページの内容

例

.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"`を追加して、閉じるボタンを反転します。これは、`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%);