副队长BootStrap5探究(28)--气泡Popover

点此查看 所有教程、项目、源码导航

文章目录

  • [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. 小结

  1. Popover气泡 和Tooltip悬浮提示很像,区别:Tooltip只有单行简短文字;Popover气泡分为标题+内容,承载信息更多。
  2. Popover气泡默认触发方式是click点击,Tooltip默认hover悬浮。
  3. 同样需要手动JS实例化,不会自动初始化,底层依靠Popper处理边界自动翻转,防止气泡跑出屏幕外。
  4. data-bs-trigger="focus" 适合需要点击外部空白处关闭气泡的场景,提升交互体验。
  5. DOM是动态生成,渲染在body末尾,避免父容器设置overflow:hidden把气泡截断。
  6. 不适合放大量复杂HTML,复杂内容优先使用Modal弹窗。
相关推荐
程序员大阳5 小时前
副队长BootStrap5探究(22)--下拉菜单 Dropdown
dropdown·下拉菜单·bootstrap5
程序员大阳3 天前
副队长BootStrap5探究(17)--分页 Pagination
分页·pagination·bootstrap5
程序员大阳8 天前
副队长BootStrap5探究(8)--输入框组 input group
源码分析·bootstrap5·输入框组·input group
程序员大阳8 天前
副队长BootStrap5探究(10)--复选框 check
源码分析·复选框·bootstrap5·check
程序员大阳9 天前
副队长BootStrap5探究(5)--图片 Image
源码分析·image·图片·bootstrap5
程序员大阳9 天前
副队长BootStrap5探究(7)--表单输入框 form control
text·textarea·bootstrap5·表单输入框·form control·form label
程序员大阳10 天前
副队长BootStrap5探究(3)--彩色链接 Colored link
源码·bootstrap5·彩色链接·colored link
程序员大阳10 天前
副队长BootStrap5探究(6)--画像 Figure (图文组合组件)
源码分析·figure·图文混排·bootstrap5·画像·图文组合
程序员大阳12 天前
副队长BootStrap5教程(1)--序言
教程·背景·bootstrap5·序言