SoybeanUI 已更名为 VeanUI迁移指南包名迁移至 @vean/aria 与 @vean/ui,文档站迁至 veanui.com。本站将于 2026 年 11 月重定向,@soybeanjs 系列包将于 2027 年 4 月标记废弃。
组件
返回目录
组件详情入口
浮层
@soybeanjs/ui
SDialog

Dialog

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

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

快速跳转

同分类组件

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

更新日志

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

v0.40.0

2026-09-14

对比版本

修复

通过语言环境为仅含图标的关闭触发器添加标签

范围: dialog作者: soybeanfe查看提交abe07

修复

恢复默认显示全屏切换按钮

范围: dialog作者: soybeanfe查看提交600a0

修复

默认隐藏全屏切换按钮

范围: dialog作者: soybeanfe查看提交3ae1c

重构

移除冗余的默认 showFullscreen 设置

范围: dialog作者: soybeanfe查看提交956d7

修复

通过语言环境为仅含图标的关闭触发器添加标签

范围: dialog作者: soybeanfe查看提交abe07

v0.30.0

2026-08-20

对比版本

新功能

添加全屏和可拖动功能

范围: dialog作者: soybeanjs查看提交fac2c

新功能

添加全屏和可拖动功能

范围: dialog作者: soybeanjs查看提交fac2c

v0.22.3

2026-05-17

对比版本

修复

调整弹出窗口的最大高度,以提高响应速度

范围: dialog作者: soybeanfe查看提交9e115

v0.17.0

2026-05-03

对比版本

优化

将 DialogRootProps 重命名为扩展 DialogBaseProps,以保持一致性

范围: dialog作者: soybeanjs查看提交7b052

v0.15.0

2026-04-26

对比版本

破坏性变更

实现 DialogCompact 并重构 `useDialog`

范围: dialog作者: soybeanjs查看提交39019

新功能

在 DialogCompact 组件中启用 showConfirm 选项

范围: dialog作者: soybeanfe查看提交e8a13

优化

增强 DialogCompact 组件的插槽道具绑定

范围: dialog作者: soybeanfe查看提交a3c2d

破坏性变更

实现 DialogCompact 并重构 `useDialog`

范围: dialog作者: soybeanjs查看提交39019

新功能

在 DialogCompact 组件中启用 showConfirm 选项

范围: dialog作者: soybeanfe查看提交e8a13

优化

增强 DialogCompact 组件的插槽道具绑定

范围: dialog作者: soybeanfe查看提交a3c2d

v0.13.8

2026-03-24

对比版本

修复

为响应式设计更新内容样式

范围: dialog作者: soybeanjs查看提交77fa2

v0.12.1

2026-03-07

对比版本

优化

更新对话框内容样式,使用 w-max,以提高响应速度

范围: dialog作者: soybeanjs查看提交eb13c

v0.11.4

2026-03-06

对比版本

新功能

为对话框内容大小添加最小宽度限制

范围: dialog作者: soybeanjs查看提交9a5e1

v0.11.3

2026-03-06

对比版本

新功能

更新对话框尺寸变量的最大宽度

范围: dialog作者: soybeanjs查看提交417a0

v0.11.2

2026-03-06

对比版本

新功能

为绑定内容类添加类道具

范围: dialog作者: soybeanjs查看提交1e779

v0.10.3

2026-03-06

对比版本

修复

删除 rounded-lg 类中不必要的 sm: 前缀

范围: dialog作者: soybeanjs查看提交30fd6

v0.0.8

2026-01-01

对比版本

重构

用 DialogPopup 代替 DialogContent,并更新相关类型和上下文管理,以改进结构和功能

范围: dialog作者: soybeanjs查看提交4d82e

重构

将 DialogPopup 更名为 DialogContent

范围: dialog作者: soybeanjs查看提交e0796

v0.0.2

2025-11-18

对比版本

新功能

实现一个具备上下文管理和无障碍功能的对话框组件

范围: dialog作者: soybeanjs查看提交adfcc

新功能

引入 DialogContentImpl 组件,以改进焦点管理并实现可关闭层功能

范围: dialog作者: soybeanjs查看提交8861f

新功能

集成 useHideOthers 可组合函数,以提升无障碍体验和焦点管理

范围: dialog作者: soybeanjs查看提交1139a

新功能

添加一个对话框示例组件,展示 DialogRoot、DialogTrigger 及相关元素的使用方法

范围: dialog作者: soybeanjs查看提交e08d4

新功能

在对话框插槽中暴露 closeModal 函数,以增强控制能力

范围: dialog作者: soybeanjs查看提交2f005

新功能

引入 DialogThemeContext 以支持主题定制,并新增 DialogHeader 和 DialogFooter 组件

范围: dialog作者: soybeanjs查看提交f2b65

新功能

新增 Dialog 组件及其相关上下文、关闭操作和类型,以增强对话框功能

范围: dialog作者: soybeanjs查看提交8378a

新功能

添加多个对话框示例,包括默认、页脚、状态控制以及阻止关闭功能

范围: dialog作者: soybeanjs查看提交9bdd9

新功能

新增 SDialogPure 组件,支持自定义属性及变体

范围: dialog作者: soybeanjs查看提交5ff73

新功能

为 DialogClose 组件添加 beforeClose 属性,用于控制关闭行为

范围: dialog作者: soybeanjs查看提交35bd1

新功能

更新 `beforeClose` 属性,允许在 `Dialog` 和 `AlertDialog` 组件中返回 `void`

范围: dialog作者: soybeanjs查看提交f295b

新功能

实现 useDialog 可组合函数,并集成 DialogProvider 以增强对话框管理功能

范围: dialog作者: soybeanjs查看提交2041c

修复

调整关闭图标的位置,并在对话框内容中添加 `outline-none` 属性,以提升无障碍体验并保持视觉一致性

范围: dialog作者: soybeanjs查看提交40fc9

修复

移除未使用的主题上下文,并更新 DialogClose 类的绑定

范围: dialog作者: soybeanjs查看提交be3ae

优化

更新 DialogClose 组件以使用主题上下文,并将 closeIcon 重命名为 closable

范围: dialog作者: soybeanjs查看提交82210

重构

更新对话框组件,使其在可关闭层和焦点范围属性上使用 v-bind

范围: dialog作者: soybeanjs查看提交ceba2

重构

将 closeModal 替换为 onOpenChange,以改进对话框状态管理

范围: dialog作者: soybeanjs查看提交430be

重构

通过移除未使用的导入并优化焦点管理,简化对话框组件的结构

范围: dialog作者: soybeanjs查看提交5072c

重构

通过更新属性绑定并整合上下文导入,优化对话框组件的结构

范围: dialog作者: soybeanjs查看提交a4447

重构

重构对话框上下文和提供程序,移除遗留代码并增强对话框管理功能

范围: dialog作者: soybeanjs查看提交de4f2

新功能

为 DialogClose 组件添加 beforeClose 属性,用于控制关闭行为

范围: dialog作者: soybeanjs查看提交35bd1

新功能

更新 `beforeClose` 属性,允许在 `Dialog` 和 `AlertDialog` 组件中返回 `void`

范围: dialog作者: soybeanjs查看提交f295b

新功能

实现 useDialog 可组合函数,并集成 DialogProvider 以增强对话框管理功能

范围: dialog作者: soybeanjs查看提交2041c

重构

重构对话框上下文和提供程序,移除遗留代码并增强对话框管理功能

范围: dialog作者: soybeanjs查看提交de4f2

新功能

实现一个具备上下文管理和无障碍功能的对话框组件

范围: dialog作者: soybeanjs查看提交adfcc

新功能

引入 DialogContentImpl 组件,以改进焦点管理并实现可关闭层功能

范围: dialog作者: soybeanjs查看提交8861f

新功能

集成 useHideOthers 可组合函数,以提升无障碍体验和焦点管理

范围: dialog作者: soybeanjs查看提交1139a

新功能

添加一个对话框示例组件,展示 DialogRoot、DialogTrigger 及相关元素的使用方法

范围: dialog作者: soybeanjs查看提交e08d4

新功能

在对话框插槽中暴露 closeModal 函数,以增强控制能力

范围: dialog作者: soybeanjs查看提交2f005

新功能

引入 DialogThemeContext 以支持主题定制,并新增 DialogHeader 和 DialogFooter 组件

范围: dialog作者: soybeanjs查看提交f2b65

新功能

新增 Dialog 组件及其相关上下文、关闭操作和类型,以增强对话框功能

范围: dialog作者: soybeanjs查看提交8378a

新功能

添加多个对话框示例,包括默认、页脚、状态控制以及阻止关闭功能

范围: dialog作者: soybeanjs查看提交9bdd9

新功能

新增 SDialogPure 组件,支持自定义属性及变体

范围: dialog作者: soybeanjs查看提交5ff73

修复

调整关闭图标的位置,并在对话框内容中添加 `outline-none` 属性,以提升无障碍体验并保持视觉一致性

范围: dialog作者: soybeanjs查看提交40fc9

修复

移除未使用的主题上下文,并更新 DialogClose 类的绑定

范围: dialog作者: soybeanjs查看提交be3ae

优化

更新 DialogClose 组件以使用主题上下文,并将 closeIcon 重命名为 closable

范围: dialog作者: soybeanjs查看提交82210

重构

更新对话框组件,使其在可关闭层和焦点范围属性上使用 v-bind

范围: dialog作者: soybeanjs查看提交ceba2

重构

将 closeModal 替换为 onOpenChange,以改进对话框状态管理

范围: dialog作者: soybeanjs查看提交430be

重构

通过移除未使用的导入并优化焦点管理,简化对话框组件的结构

范围: dialog作者: soybeanjs查看提交5072c

重构

通过更新属性绑定并整合上下文导入,优化对话框组件的结构

范围: dialog作者: soybeanjs查看提交a4447