气泡卡片 Popovers

气泡卡片是带标题与正文的小型浮层,用来给按钮、图标等元素补充说明。本页壳脚本已统一初始化所有 data-bs-toggle="popover" 元素,直接写标记即可生效。

四个方向

通过 data-bs-placement 指定气泡出现在触发元素的上、右、下、左四个方向;data-bs-container="body" 让气泡挂载到 body,避免被父容器的边框或圆角裁剪。

HTML 示例

自定义 HTML 内容

加上 data-bs-html="true" 后,data-bs-title 与 data-bs-content 中的 HTML 标签会被渲染而不是转义为纯文本。

HTML 示例

禁用元素上的气泡

带 disabled 的元素本身不响应鼠标与键盘事件,需要用一个外层 <span> 包裹它,把 data-bs-toggle="popover" 放在包裹层上,并加 tabindex="0" 保证键盘可达。

HTML 示例

下次点击时关闭

设置 data-bs-trigger="focus",气泡会在用户点击触发元素之外的任意位置时自动关闭。注意官方要求触发器用 <a> 标签并带 tabindex="0",以保证跨浏览器行为一致。

HTML 示例