点此查看 所有教程、项目、源码导航
文章目录
- [1. 开篇介绍与环境引入](#1. 开篇介绍与环境引入)
- [2. 使用方法](#2. 使用方法)
-
- [2.1 基础气泡 Popover](#2.1 基础气泡 Popover)
- [2.2 设置气泡弹出方向](#2.2 设置气泡弹出方向)
- [2.3 点击外部关闭(dismiss模式)](#2.3 点击外部关闭(dismiss模式))
- [3. 底层实现关键点解析](#3. 底层实现关键点解析)
- [4. 小结](#4. 小结)
1. 开篇介绍与环境引入
气泡 Popover,和Tooltip悬浮提示很像,但是支持放置标题+正文,内容容量更大,默认点击触发,同样依赖Popper做定位,需要JS初始化。
先引入BootStrap相关的环境:
html
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title></title>
<!-- Bootstrap 5 CSS -->
<link rel="stylesheet" href="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/5.3.8/css/bootstrap.min.css">
</head>
<body>
<!-- Bootstrap JS + Popper,用于部分交互 -->
<script src="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/5.3.8/js/bootstrap.bundle.min.js"></script>
</body>
</html>
2. 使用方法
2.1 基础气泡 Popover
data-bs-toggle="popover",title 是气泡标题,data-bs-content 是气泡正文内容,必须JS初始化才生效。
html
<button class="btn btn-primary" data-bs-toggle="popover" title="气泡标题" data-bs-content="这里是Popover气泡的正文内容,可以放更多文字。">
点击弹出气泡
</button>
<script>
// 统一初始化页面所有popover气泡
const popoverList = document.querySelectorAll('[data-bs-toggle="popover"]')
const popoverArr = [...popoverList].map(el => new bootstrap.Popover(el))
</script>
效果:

2.2 设置气泡弹出方向
data-bs-placement 控制气泡弹出方位,top / right / bottom / left。
html
<button class="btn btn-secondary m-2" data-bs-toggle="popover" data-bs-placement="top" title="上方气泡" data-bs-content="向上弹出气泡">top</button>
<button class="btn btn-secondary m-2" data-bs-toggle="popover" data-bs-placement="right" title="右侧气泡" data-bs-content="向右弹出气泡">right</button>
效果:

2.3 点击外部关闭(dismiss模式)
增加 data-bs-trigger="focus",点击页面其他空白地方,自动关闭气泡。
html
<button class="btn btn-info" data-bs-toggle="popover" data-bs-trigger="focus" title="可关闭气泡" data-bs-content="点击页面空白处关闭这个气泡">
focus触发气泡
</button>
3. 底层实现关键点解析
下面是精简复刻版本,去掉大量浏览器兼容代码,只保留核心逻辑。
使用上面的HTML代码,加下面自己写的CSS + JS,能得到基本类似的效果,大家可以尝试下。
css
.popover {
/* 绝对定位,由JS实时计算位置 */
position: absolute;
z-index: 1070;
/* 默认隐藏气泡 */
display: none;
/* 不接收鼠标事件,防止鼠标移入气泡时闪烁 */
pointer-events: none;
}
.popover.show {
display: block;
}
.popover-header {
/* 气泡头部标题区域 */
padding: 0.5rem 1rem;
margin-bottom: 0;
font-size: 1rem;
background-color: #f0f0f0;
border-bottom: 1px solid #e5e5e5;
border-radius: 0.5rem 0.5rem 0 0;
}
.popover-body {
/* 气泡正文区域 */
padding: 1rem 1rem;
color: #212529;
}
.popover-arrow {
/* 气泡的小三角箭头 */
position: absolute;
width: 0;
height: 0;
border-style: solid;
border-color: transparent;
}
.popover-top .popover-arrow {
bottom: 0;
left: 50%;
transform: translateX(-50%);
border-top-color: #fff;
border-width: 0 0.5rem 0.5rem;
}
.popover-bottom .popover-arrow {
top: 0;
left: 50%;
transform: translateX(-50%);
border-bottom-color: #fff;
border-width: 0.5rem 0.5rem 0;
}
js
// 简易复刻Popover气泡核心逻辑,只实现top向上弹出方向
class SimplePopover {
constructor(el, options = {}) {
this.el = el;
this.placement = options.placement || 'top';
this.title = el.getAttribute('title');
this.content = el.dataset.bsContent;
this.trigger = options.trigger || 'click';
// 移除原生title,避免浏览器自带悬浮提示干扰
el.removeAttribute('title');
// 创建气泡DOM结构
this.popoverDom = document.createElement('div');
this.popoverDom.className = 'popover';
this.popoverDom.innerHTML = `
<div class="popover-arrow"></div>
<div class="popover-header">${this.title}</div>
<div class="popover-body">${this.content}</div>
`
document.body.appendChild(this.popoverDom);
// 绑定触发事件
if(this.trigger === 'click'){
this.el.addEventListener('click', () => this.toggle())
}
}
toggle() {
// 切换显示/隐藏
if(this.popoverDom.classList.contains('show')){
this.hide();
}else{
this.show();
}
}
show() {
// 获取目标元素在页面上的位置信息
const rect = this.el.getBoundingClientRect();
this.popoverDom.classList.add('show', 'popover-top');
// 简单定位:放在元素上方居中
this.popoverDom.style.left = rect.left + rect.width / 2 + 'px';
this.popoverDom.style.top = rect.top - 8 + 'px';
}
hide() {
this.popoverDom.classList.remove('show');
}
}
// 页面初始化所有气泡
document.querySelectorAll('[data-bs-toggle="popover"]').forEach(item=>{
new SimplePopover(item, {
placement: item.dataset.bsPlacement,
trigger: item.dataset.bsTrigger
})
})
效果:

4. 小结
- Popover气泡 和Tooltip悬浮提示很像,区别:Tooltip只有单行简短文字;Popover气泡分为标题+内容,承载信息更多。
- Popover气泡默认触发方式是click点击,Tooltip默认hover悬浮。
- 同样需要手动JS实例化,不会自动初始化,底层依靠Popper处理边界自动翻转,防止气泡跑出屏幕外。
data-bs-trigger="focus"适合需要点击外部空白处关闭气泡的场景,提升交互体验。- DOM是动态生成,渲染在body末尾,避免父容器设置overflow:hidden把气泡截断。
- 不适合放大量复杂HTML,复杂内容优先使用Modal弹窗。