跳到主要内容
前端术语库

气泡卡片

Popover

UI 组件也叫:弹出卡片、气泡框、Popconfirm、浮动卡片

一句话:点击或悬停某个元素后,在它旁边弹出的小卡片,可以放标题、几行说明甚至按钮。

详细解释

气泡卡片贴着触发它的元素弹出,带一个小三角箭头指向来源,不遮挡整个页面,也没有遮罩。点击卡片外的地方或再次点击触发元素,它就会收起。常见用途有:头像上弹出用户资料卡、「删除」按钮旁弹出「确定删除吗」的小确认框(Ant Design 里叫 Popconfirm)、表头里弹出筛选选项。

它和 文字提示(Tooltip)的区别是:文字提示只放一句纯文字,悬停出现、移开就消失;气泡卡片可以放标题、图片和按钮,用户能把鼠标移进去操作。和 对话框 的区别是:对话框居中弹出、盖住整个页面、必须处理完才能继续;气泡卡片只占一小块,是轻量的补充信息。

示例

灰度线框示意,只表达结构,不代表具体视觉风格。

怎么跟 AI 说

可以直接贴给 Cursor、Claude Code 等工具,把里面的业务内容换成你自己的。

点击用户头像时,在头像正下方弹出一个宽 280px 的气泡卡片,带指向头像的小箭头,里面显示头像、昵称、简介和「发消息」按钮;点击卡片外部或按 Esc 关闭,靠近屏幕边缘时自动换到另一侧弹出。

结构与适用场景

结构描述

由触发元素和浮动卡片组成,卡片带指向触发元素的小箭头,内部可有标题、内容区和操作按钮。

适用场景

  • 悬停或点击某个对象时,需要就地展示几行补充信息或一张资料卡
  • 删除、撤回这类单个操作前,需要在按钮旁做一次轻量确认
  • 需要在按钮旁放少量设置项或筛选选项,改完即收起

不适用场景

  • 只需一句纯文字解释图标或按钮含义时,用文字提示更轻
  • 内容包含长表单或多步操作,需要用户专注处理时
  • 必须让用户做出决定才能继续后续流程时

常见坏用法

  • 用悬停触发气泡卡片,里面却放了需要点击的按钮,鼠标一移过去卡片就消失了
  • 卡片里塞长表单或长列表,超出屏幕后还得在卡片内部滚动
  • 忘了设置层级,卡片被表格固定列或顶部导航挡住

识别特征

  • 紧挨着某个按钮或头像的小白卡片,带投影
  • 卡片一侧有指向触发元素的小三角
  • 背后没有遮罩,页面其余部分正常可见

DOM 线索

插件本地识别时匹配的 CSS 选择器(标签、ARIA role、常见组件库 class)。

  • .ant-popover
  • .el-popover
  • [class*="MuiPopover-paper"]
  • .arco-popover-content
  • .n-popover:not(.n-tooltip)
  • [data-slot="popover-content"]
  • .popover
  • [popover]:not([role="tooltip"])