警告框

警告框组件能够展示任意长度的文本以及一个可选的关闭按钮。为了展示合适的样式,必须 从下列 8 个情境类(例如 .alert-success)中选择一个合适的并使用。

带连接的警告框

通过使用 .alert-link 工具类可以为任何警告框(alert)组件添加颜色相匹配的链接。

添加其它内容

警告框(alert)组件还可以包含其它 HTML 元素,例如标题、段落、分割线等。

图标

类似地,您可以使用flexbox工具和Bootstrap图标创建带有图标的警告框。根据图标和内容,您可能需要添加更多实用程序或自定义样式。

您的警告框需要多个图标吗?考虑使用更多的Bootstrap图标并制作一个本地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="Info:"><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="Success:"><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="Warning:"><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="Danger:"><use xlink:href="#exclamation-triangle-fill"/></svg>
  <div>
    第十七回 韩擒虎调兵二路 伍云召被困危城
  </div>
</div>

大部分人可能不知道该怎么去创建一个自己想要的svg图标,因为模板中已经集成字体图标(Material Design Icons 6.5.95),所以直接用这些字体图标即可。

可以使用 fs-2 这样的通用 class 设置字体图标的大小。

关闭警告框

通过使用警告框(alert)组件的 JavaScript 插件,可以为任何警告框(alert)组件添加内联的关闭按钮。步骤如下:

  • 确保已加载了警告框(alert)组件的 JavaScript 插件,或者是 Bootstrap 的预编译 JavaScript 文件。
  • 添加 关闭按钮 和 .alert-dismissible 类,这将在警告框(alert)组件的右侧增加额外的空间并放置关闭按钮。
  • 在关闭按钮上添加 data-bs-dismiss="alert" 属性,该属性会触发 JavaScript 代码。请务必使用 >button< 元素,以确保在所有设备上都具有正确的行为。
  • 如需在关闭警告框(alert)时展示动画效果,请确保添加 .fade 和 .show。
当警告框(alert)被关闭后,该元素将从页面结构中被删除。如果使用键盘的用户通过关闭按钮关闭了警告框(alert),那么将在页面上丢失焦点并被重置为页面/文档的起始位置(该行为取决于浏览器)。出于这个原因,我们建议你添加额外的 JavaScript 代码来监听 closed.bs.alert 事件,并通过代码调用 focus() 将焦点设置为页面中最合适的位置。如果你打算将焦点移到通常不会获取焦点的元素上的话,请确保为该元素添加了 tabindex="-1" 属性。