メインコンテンツにスキップ ドキュメントナビゲーションにスキップ

閉じるボタン（Close button） v5.0.0設定変更

モーダルやアラートなどのコンテンツを非表示にする一般的な閉じるボタン。

※"v5.0.0"での変更はv5.0.0-alpha版、v5.0.0-beta版での変更も含みます。

※"v5.2.0"での変更はv5.2.0-beta1での変更も含みます。
※"v5.3.0"での変更はv5.3.0-alpha版での変更も含みます。
このページの項目 v5.0.0設定変更

基本の設定（Example）v5.0.0-alpha2設定変更

.btn-close でコンポーネントを閉じられるオプションを提供。デフォルトでのスタイルは制限しているが、高度なカスタマイズができる。Sass変数を変更して、デフォルトの background-image を置き換える。aria-label には、必ずスクリーンリーダーのテキストを入れること。

見本
Bootstrap5.xの設定例 緑背景が変更箇所
<button type="button" class="btn-close" aria-label="閉じる"></button>
※Bootstrap4.xの設定例 赤背景が変更箇所
<button type="button" class="close" aria-label="閉じる">
  <span aria-hidden="true">&times;</span>
</button>
【設定】
  • button.btn-close[aria-label]
【注意】
  • 実際に閉じる動作をさせるには、button.btn-close[aria-label] に data-bs-dismiss="xxx" を入れる
    （xxx の部分は、アラートの場合は alert、モーダルの場合は modal、オフキャンバスの場合は offcanvas、トーストの場合は toast）
  • button.btn-close に、アイコンとなる span[aria-hidden="true"] > &times; の設定は不要（.btn-close にSVGが設定されるため）
    • アイコンボタンはSVG化されたのでRFSではなくなり、ビューポートに応じて拡大縮小しない
    • アイコンボタンを × から変更したい場合は、scss/_variables.scss 内にある $btn-close-bg に設定されているSVGの値を変更して再コンパイルする
【アクセシビリティの設定】
  • アイコンとなる button.btn-close に、aria-label 属性（アイコンボタンのラベリング）を入れる
【変更履歴】
  • 【v5.0.0-alpha1】
    • RFSがデフォルトで有効となり、ビューポートが1200px未満でボタンのフォントサイズがビューポートに応じて拡大縮小（※v5.0.0-alpha2で不要に）
  • 【v5.0.0-alpha2】
    • button.close[aria-label] > span[aria-hidden="true"] > &times; ⇒ button.btn-close[aria-label]
      • .close ⇒ .btn-close
      • span[aria-hidden="true"] > &times; が不要に

無効化状態（Disabled state）v5.0.0-alpha1新設

無効化された閉じるボタンでは、opacity を変更。また、pointer-events: none と user-select: none を適用して、hoverとactiveな状態が切り替わらないようにした。

見本
Bootstrap5.xの設定例 緑背景が変更箇所
<button type="button" class="btn-close" disabled aria-label="閉じる"></button>
※Bootstrap4.xの設定例 赤背景が変更箇所
<button type="button" class="close" disabled aria-label="閉じる">
  <span aria-hidden="true">&times;</span>
</button>
【設定】
  • button.btn-close に [disabled] を入れる

ダーク・バージョン（Dark variant）v5.0.0-alpha2新設、v5.3.0設定変更と「ホワイト・バージョン」から変更 v5.3.0非推奨

.btn-close かその親要素に data-bs-theme="dark" を追加して閉じるボタンの色を反転させられる。これは filter プロパティを使用して background-image の値を上書きせずに反転させる。

見本 ※背景に .bg-dark を追加しています

通常の場合

無効化の場合

※デフォルトの場合（参考）：ライトモードにすると違いがわかります

Bootstrap5.3.0の設定例 緑背景が5.3.0での変更箇所
通常の場合<div data-bs-theme="dark">
  <button type="button" class="btn-close" aria-label="閉じる"></button>
</div>
無効化の場合<div data-bs-theme="dark">
  <button type="button" class="btn-close" disabled aria-label="閉じる"></button>
</div>
※Bootstrap5.2.xの設定例 赤背景が5.3.0での変更箇所
通常の場合<button type="button" class="btn-close btn-close-white" aria-label="閉じる"></button>
無効化の場合<button type="button" class="btn-close btn-close-white" disabled aria-label="閉じる"></button>
【設定】
  • button.btn-close を [data-bs-theme="dark"] で囲む
【変更履歴】
  • 【v5.3.0】
    • カラーモードの新設に伴い .btn-close-white は非推奨に（v5.3.0～でも使用できるがv6で廃止予定）

CSS v5.0.0-beta3追加、v5.3.0Sassから名称変更

CSS変数（Variables）v5.3.0設定移行

Bootstrapの進化するCSS変数アプローチの一環として、閉じるボタンは、リアルタイムのカスタマイズを強化するために、.btn-close でローカルCSS変数を使用するようにした。CSS変数の値はSassを経由して設定されるため、Sassのカスタマイズも引き続きサポートされる。

デフォルトの設定
scss/_close.scss 内 close-css-vars の設定--#{$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変数（Sass variables）v5.3.0変数から名称変更

デフォルトの設定
scss/_variables.scss 内 close-variables の設定$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-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%); // v5.3.4では非推奨