SoybeanUI 已更名为 VeanUI迁移指南包名迁移至 @vean/aria 与 @vean/ui，文档站迁至 veanui.com。本站将于 2026 年 11 月重定向，@soybeanjs 系列包将于 2027 年 4 月标记废弃。

SoybeanUI

v0.50.0
组件
返回目录
组件详情入口
浮层
@soybeanjs/ui
SPopover

Popover

Popover 属于 浮层 分类。建议先看演示与用法，再对照 API 表格完成接入和样式调整。

先用快捷跳转面板找到概述、用法、演示和 API，再往下细读完整文档内容。

快速跳转

概述用法演示API更新日志

同分类组件

如果你在同一类交互里做组合，这些组件通常会一起出现。

DialogDrawerHoverCardPopconfirmSheetTooltip

更新日志

版本记录按发布版本分组，便于快速查看这个组件在不同版本里的实际变更。

v0.50.0

2026-10-02

对比版本

新功能

为 avoidCollisions 和 prioritizePosition 添加默认属性

范围: popover作者: soybeanjs查看提交f86de

新功能

为 avoidCollisions 和 prioritizePosition 添加默认属性

范围: popover作者: soybeanjs查看提交f86de

v0.19.0

2026-05-11

对比版本

新功能

添加 prioritizePosition 命题，改进定位控制

范围: popover作者: soybeanfe查看提交0bc99

修复

将 slotProps 与 PopoverCompact 模板中的插槽绑定

范围: popover作者: soybeanfe查看提交ba82c

优化

简化弹出窗口组件结构，增强关闭功能

范围: popover作者: soybeanfe查看提交f9d63

优化

简化 PopoverTrigger 中的组件结构

范围: popover作者: soybeanfe查看提交f1764

v0.17.0

2026-05-03

对比版本

优化

增强弹出式组件的上下文和道具

范围: popover作者: soybeanjs查看提交f6666

v0.16.0

2026-05-01

对比版本

新功能

为 Card、Popover、Editable、HoverCard、NavigationMenu、Pagination 和 Stepper 实现紧凑型组件

范围: components作者: soybeanjs查看提交6cbdc

v0.12.0

2026-03-07

对比版本

新功能

添加 PopoverCloseEmits 和 beforeClose 命题；更新 PopoverPositioner 默认命题

范围: popover作者: soybeanjs查看提交08e1c

v0.0.17

2026-01-19

对比版本

修复

为 PopoverPositionerImpl 添加 disable-outside-pointer-events 绑定

范围: popover作者: soybeanjs查看提交1c945

v0.0.8

2026-01-01

对比版本

优化

移除 PopoverPositioner 上下文并更新相关组件，以提高清晰度和功能性

范围: popover作者: soybeanjs查看提交de4b4

重构

移除 PopoverContent，引入 PopoverPositioner 和 PopoverPopup 组件，并加强上下文管理以改进结构和功能

范围: popover作者: soybeanjs查看提交2eb9c

v0.0.2

2025-11-18

对比版本

新功能

新增 Popover 组件，支持触发器、内容及上下文管理，以增强 UI 交互体验

范围: popover作者: soybeanjs查看提交b14c6

新功能

引入 SPopover 组件，支持自定义定位和主题样式

范围: popover作者: soybeanjs查看提交902c0

新功能

添加 close 方法并将其传递给插槽，以改进弹出框控件

范围: popover作者: soybeanjs查看提交d4520

新功能

为 popper-content 组件新增 'sideFlip' 和 'alignFlip' 属性

范围: popover作者: soybeanjs查看提交d8115

重构

集成 useBodyScrollLock 以改进模态框行为，并增强焦点管理

范围: popover作者: soybeanjs查看提交2c757

重构

通过 onWatcherCleanup 优化组件导入并增强清理管理

范围: popover作者: soybeanjs查看提交78af9

重构

通过将 setElement 函数替换为支持回调的方式，简化弹出框上下文和组件中的元素处理流程

范围: popover作者: soybeanjs查看提交4bba4

新功能

新增 Popover 组件，支持触发器、内容及上下文管理，以增强 UI 交互体验

范围: popover作者: soybeanjs查看提交b14c6

新功能

引入 SPopover 组件，支持自定义定位和主题样式

范围: popover作者: soybeanjs查看提交902c0

新功能

添加 close 方法并将其传递给插槽，以改进弹出框控件

范围: popover作者: soybeanjs查看提交d4520

新功能

为 popper-content 组件新增 'sideFlip' 和 'alignFlip' 属性

范围: popover作者: soybeanjs查看提交d8115

重构

集成 useBodyScrollLock 以改进模态框行为，并增强焦点管理

范围: popover作者: soybeanjs查看提交2c757

重构

通过 onWatcherCleanup 优化组件导入并增强清理管理

范围: popover作者: soybeanjs查看提交78af9

重构

通过将 setElement 函数替换为支持回调的方式，简化弹出框上下文和组件中的元素处理流程

范围: popover作者: soybeanjs查看提交4bba4