アラート（Alerts）

アラートの設定（Examples）

アラートは任意の長さのテキストとオプションの閉じるボタンで利用できる。適切なスタイルを設定するには、必要な8つの色クラス（例：.alert-success）のいずれかを使用。インラインで閉じる場合、アラートJavaScriptプラグインを使用。

色の種類

設定例

コピー<div class="alert alert-primary" role="alert"><strong>アラート</strong> - チェックしてください！</div>

ライブの実例（Live example）v5.1.0新設

下のボタンをクリックしてアラートを表示し（開始するにはインラインスタイルで非表示）、組み込みの閉じるボタンでアラートを閉じる（そして破棄）。

見本

設定例

HTMLコピー<div id="liveAlertPlaceholder"></div>
<button type="button" class="btn btn-primary" id="liveAlertBtn">ライブでアラートを表示</button>

次のJavaScriptを使用して、ライブでアラートデモを起動。

JavaScriptコピーvar alertPlaceholder = document.getElementById('liveAlertPlaceholder')
var alertTrigger = document.getElementById('liveAlertBtn')

function alert(message, type) {
  var wrapper = document.createElement('div')
  wrapper.innerHTML = '<div class="alert alert-' + type + ' alert-dismissible" role="alert">' + message + '<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="閉じる"></button></div>'

  alertPlaceholder.append(wrapper)
}

if (alertTrigger) {
  alertTrigger.addEventListener('click', function () {
    alert('いいね！このアラートメッセージを起動しました。', 'success')
  })
}

アラート内のリンクの色（Link color）

.alert-link ユーティリティ・クラスを使用すると、アラート内の色付きリンクが手早く表示できる。

見本

設定例

コピー<div class="alert alert-primary" role="alert"><strong>太字！</strong>　<a href="#" class="alert-link">リンク文字</a>　普通の文字</div>

追加コンテンツ（Additional content）

アラートには、見出し、段落、仕切り線などの追加のHTML要素も入れられる。

見本

設定例

コピー<div class="alert alert-success" role="alert">
  <h4 class="alert-heading">よくやった！</h4>
  <p>ええ、あなたはこの重要な警告メッセージを正常に読むことができます。このサンプルテキストは、少し長く実行されるため、アラート内の空白がこの種のコンテンツでどのように動作するかを確認することができます。</p>
  <hr>
  <p class="mb-0">必要なときはいつでもマージンユーティリティを使用して、素敵に整えてください。</p>
</div>

アイコン付き（Icons）v5.0.0新設

同様に、flexboxユーティリティとBootstrap Iconsを使用して、アイコン付きのアラートが作成できる。アイコンとコンテンツによっては、ユーティリティやカスタムスタイルの追加もできる。

1.単独でアイコンを使用する場合

見本

設定例

コピー<div class="alert alert-primary d-flex align-items-center" role="alert">
  <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" fill="currentColor" class="bi bi-exclamation-triangle-fill flex-shrink-0 me-2" viewBox="0 0 16 16" role="img" aria-label="警告:">
    <path d="M8.982 1.566a1.13 1.13 0 0 0-1.96 0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889 0 1.438-.99.98-1.767L8.982 1.566zM8 5c.535 0 .954.462.9.995l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 5.995A.905.905 0 0 1 8 5zm.002 6a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
  </svg>
  <div>
    アイコン付きのアラートの例
  </div>
</div>

2.アイコンを繰り返し使用する場合

アラートに複数のアイコンが必要なら、同じアイコンを繰り返し簡単に参照できるようにより多くのBootstrap Iconsを使用してローカルSVGスプライトを作成する。

見本

設定例

コピー<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
  <symbol id="check-circle-fill" fill="currentColor" viewBox="0 0 16 16">
    <path d="M16 8A8 8 0 1 1 0 8a8 8 0 0 1 16 0zm-3.97-3.03a.75.75 0 0 0-1.08.022L7.477 9.417 5.384 7.323a.75.75 0 0 0-1.06 1.06L6.97 11.03a.75.75 0 0 0 1.079-.02l3.992-4.99a.75.75 0 0 0-.01-1.05z"/>
  </symbol>
  <symbol id="info-fill" fill="currentColor" viewBox="0 0 16 16">
    <path d="M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16zm.93-9.412-1 4.705c-.07.34.029.533.304.533.194 0 .487-.07.686-.246l-.088.416c-.287.346-.92.598-1.465.598-.703 0-1.002-.422-.808-1.319l.738-3.468c.064-.293.006-.399-.287-.47l-.451-.081.082-.381 2.29-.287zM8 5.5a1 1 0 1 1 0-2 1 1 0 0 1 0 2z"/>
  </symbol>
  <symbol id="exclamation-triangle-fill" fill="currentColor" viewBox="0 0 16 16">
    <path d="M8.982 1.566a1.13 1.13 0 0 0-1.96 0L.165 13.233c-.457.778.091 1.767.98 1.767h13.713c.889 0 1.438-.99.98-1.767L8.982 1.566zM8 5c.535 0 .954.462.9.995l-.35 3.507a.552.552 0 0 1-1.1 0L7.1 5.995A.905.905 0 0 1 8 5zm.002 6a1 1 0 1 1 0 2 1 1 0 0 1 0-2z"/>
  </symbol>
</svg>

<div class="alert alert-primary d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" width="24" height="24" role="img" aria-label="情報:"><use xlink:href="#info-fill"/></svg>
  <div>
    アイコン付きのアラートの例
  </div>
</div>
<div class="alert alert-success d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" width="24" height="24" role="img" aria-label="成功:"><use xlink:href="#check-circle-fill"/></svg>
  <div>
    アイコン付きの成功アラートの例
  </div>
</div>
<div class="alert alert-warning d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" width="24" height="24" role="img" aria-label="警告:"><use xlink:href="#exclamation-triangle-fill"/></svg>
  <div>
    アイコン付きの警告アラートの例
  </div>
</div>
<div class="alert alert-danger d-flex align-items-center" role="alert">
  <svg class="bi flex-shrink-0 me-2" width="24" height="24" role="img" aria-label="危険:"><use xlink:href="#exclamation-triangle-fill"/></svg>
  <div>
    アイコン付きの危険アラートの例
  </div>
</div>

メッセージを閉じるボタン（Dismissing）v5.0.0-beta1設定変更

アラートJavaScriptプラグインを使用すると、アラートをすべて閉じることができます。方法は次のとおり：

• アラートプラグインかコンパイル済のBootstrapのJavaScriptファイルを読み込む。
• 閉じるボタンと.alert-dismissible クラスを追加。これにより、アラートの行末側に余白が追加され、.btn-close ボタンが配置される。
• 閉じるボタンで、data-bs-dismiss="alert" 属性を追加。これにより、JavaScript機能が起動される。すべてのデバイスで適切な動作をさせるには、必ず <button> 要素を使用すること。
• アラートを閉じるときにアラートをアニメーション化するには、必ず .fade と .show のクラスを追加すること。

以下の見本でこれを見られる。
※実例としてモーダルを利用してアラートを表示する方法をモーダルでアラート表示に掲載。

見本

Bootstrap5.xの設定例 緑背景が変更箇所

<div class="alert alert-warning alert-dismissible fade show" role="alert">
  <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="閉じる"></button>
  <strong>注意!</strong>　このアラートはあなたの注意が必要です。
</div>

※Bootstrap4.xの設定例 赤背景が変更箇所

<div class="alert alert-warning alert-dismissible fade show" role="alert">
  <strong>注意!</strong>　このアラートはあなたの注意が必要です。
  <button type="button" class="close" data-dismiss="alert" aria-label="閉じる">
    <span aria-hidden="true">&times;</span>
  </button>
</div>

Sass v5.0.0-beta3追加

変数（Variables）

デフォルトの設定

scss/_variables.scss 内 alert-variables の設定$alert-padding-y:               $spacer;
$alert-padding-x:               $spacer;
$alert-margin-bottom:           1rem;
$alert-border-radius:           $border-radius;
$alert-link-font-weight:        $font-weight-bold;
$alert-border-width:            $border-width;
$alert-bg-scale:                -80%;
$alert-border-scale:            -70%;
$alert-color-scale:             40%;
$alert-dismissible-padding-r:   $alert-padding-x * 3; // 3xは、xの幅に加えて、両側のデフォルトのパディングをカバー

バリエーションmixin（Variant mixin）

$theme-colors と組み合わせて使用し、アラートのコンテキスト修飾子クラスを作成。

デフォルトの設定

scss/mixins/_alert.scss 内 alert-variant-mixin の設定@mixin alert-variant($background, $border, $color) {
  color: $color;
  @include gradient-bg($background);
  border-color: $border;

  .alert-link {
    color: shade-color($color, 20%);
  }
}

ループ（Loop)

alert-variant() mixinを使用して修飾子クラスを生成するループ。

デフォルトの設定

scss/_alert.scss 内 alert-modifiers の設定// アラートを色付けするためのコンテキスト修飾子クラスを生成

@each $state, $value in $theme-colors {
  $alert-background: shift-color($value, $alert-bg-scale);
  $alert-border: shift-color($value, $alert-border-scale);
  $alert-color: shift-color($value, $alert-color-scale);
  @if (contrast-ratio($alert-background, $alert-color) < $min-contrast-ratio) {
    $alert-color: mix($value, color-contrast($alert-background), abs($alert-color-scale));
  }
  .alert-#{$state} {
    @include alert-variant($alert-background, $alert-border, $alert-color);
  }
}

JavaScriptの動作（JavaScript behavior）v5.0.0-alpha1設定変更

初期化（Initialize）v5.1.0追加

要素をアラートとして初期化。

Bootstrap5.xの設定例 v5.1.0変更

JavaScriptコピーvar alertList = document.querySelectorAll('.alert')
var alerts =  [].slice.call(alertList).map(function (element) {
  return new bootstrap.Alert(element)
})

※Bootstrap4.xの設定例

$('.alert').alert()

トリガー（Triggers）

アラートを閉じるには、下記のようにアラート内のボタンの data 属性を使用して実行できる：

設定例

HTMLコピー<button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="閉じる">
</button>

または、下記のようにアラートの外側のボタンで data-bs-target を使用して閉じることもできる：

設定例

コピー<button type="button" class="btn-close" data-bs-dismiss="alert" data-bs-target="#my-alert" aria-label="閉じる"></button>

アラートを閉じると、DOMから削除されるので注意。

メソッド（Methods）v5.0.0-alpha1設定変更、v5.0.2メソッド追加

アラート・コンストラクタを使用してアラート・インスタンスが作成できる。以下に例を表示：

設定例 v5.0.0-alpha1変更

JavaScriptコピーvar myAlert = document.getElementById('myAlert')
var bsAlert = new bootstrap.Alert(myAlert)

これは data-bs-dismiss="alert" 属性を持つ子孫要素上でクリック・イベントをアラートに従わせる（data-apiの自動初期化を使用する場合は不要）。

getInstance の設定例

JavaScriptコピーvar alertNode = document.querySelector('.alert')
var alert = bootstrap.Alert.getInstance(alertNode)
alert.close()

イベント（Events）

Bootstrapのアラートプラグインは、アラート機能に接続するためにいくつかのイベントを公開する。

使用例 v5.0.0-alpha1設定変更

JavaScriptコピーvar myAlert = document.getElementById('myAlert')
myAlert.addEventListener('closed.bs.alert', function () {
  // 何かをする、たとえば、フォーカスを最も適切な要素に明示的に移動する、
  // そのため、ページの先頭に失われたりリセットされたりすることはない
  // document.getElementById('...').focus()
})