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

Menu

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

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

快速跳转

同分类组件

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

更新日志

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

v0.31.0

2026-08-31

对比版本

样式

优化菜单空间

范围: menu作者: soybeanjs查看提交5c0a5

v0.30.0

2026-08-20

对比版本

优化

添加默认的 prioritizePosition 属性

范围: menu作者: soybeanjs查看提交0b47e

优化

添加默认的 prioritizePosition 属性

范围: menu作者: soybeanjs查看提交45fed

优化

添加默认的 prioritizePosition 属性

范围: menu作者: soybeanjs查看提交0b47e

优化

添加默认的 prioritizePosition 属性

范围: menu作者: soybeanjs查看提交45fed

v0.15.0

2026-04-26

对比版本

新功能

添加 MenuSubAttributeContext 并集成到菜单组件中

范围: menu作者: soybeanjs查看提交7bc9f

修复

在 PopperPositioner 和 RovingFocusGroup 中正确处理焦点

范围: menu作者: soybeanjs查看提交68b9d

重构

实施菜单紧凑组件

范围: menu作者: soybeanjs查看提交a1e6d

维护

为 SMenuOptions 键盘导航添加单元测试

范围: menu作者: soybeanjs查看提交a4532

样式

将菜单项的光标样式从默认值改为指针式

范围: menu作者: soybeanjs查看提交c47ff

新功能

添加 MenuSubAttributeContext 并集成到菜单组件中

范围: menu作者: soybeanjs查看提交7bc9f

修复

在 PopperPositioner 和 RovingFocusGroup 中正确处理焦点

范围: menu作者: soybeanjs查看提交68b9d

重构

实施菜单紧凑组件

范围: menu作者: soybeanjs查看提交a1e6d

维护

为 SMenuOptions 键盘导航添加单元测试

范围: menu作者: soybeanjs查看提交a4532

样式

将菜单项的光标样式从默认值改为指针式

范围: menu作者: soybeanjs查看提交c47ff

v0.14.0

2026-04-03

对比版本

重构

增强菜单项单选和复选框组件

范围: menu作者: soybeanjs查看提交233ff

v0.3.0

2026-01-29

对比版本

新功能

支持活动状态

范围: menu作者: soybeanjs查看提交32476

v0.1.11

2026-01-28

对比版本

修复

为弹出窗口添加可视焦点轮廓,使其更易于访问

范围: menu作者: soybeanjs查看提交f5509

v0.0.20

2026-01-21

对比版本

新功能

支撑指示器位置

范围: menu作者: soybeanjs查看提交f7da3

v0.0.8

2026-01-01

对比版本

优化

增强类型定义

范围: menu作者: soybeanjs查看提交e2fb8

重构

通过引入弹出式和定位器元素、更新上下文管理以及增强类型定义来重组菜单组件,以提高清晰度和功能性

范围: menu作者: soybeanjs查看提交f4143

v0.0.2

2025-11-18

对比版本

新功能

实现带有上下文管理、导航和无障碍功能的菜单组件结构

范围: menu作者: soybeanjs查看提交e27d7

新功能

新增 MenuSubTrigger 组件,并更新 MenuRoot 的 props 以增强功能

范围: menu作者: soybeanjs查看提交c3b85

新功能

添加菜单组件名称

范围: menu作者: soybeanjs查看提交58293

新功能

将 MenuLabel 替换为 MenuGroupLabel,并为菜单组件添加主题上下文支持

范围: menu作者: soybeanjs查看提交02a5b

修复

更新可关闭层以使用 contentElement,并通过新的辅助函数改进焦点处理

范围: menu作者: soybeanjs查看提交9cbc7

修复

更新筛选逻辑,仅包含常用插槽

范围: menu作者: soybeanjs查看提交b4810

修复

将 separatorProps 绑定到 MenuSeparator 以提升功能

范围: menu作者: soybeanjs查看提交da975

修复

调整菜单变体中内容的最小宽度,以优化布局

范围: menu作者: soybeanjs查看提交50e8b

重构

移除未使用的 useCollection 可组合函数,并整合 useHideOthers 以实现更好的焦点管理

范围: menu作者: soybeanjs查看提交6a02b

重构

简化上下文管理,并增强菜单组件间的元素处理能力

范围: menu作者: soybeanjs查看提交976cf

重构

通过集成 PopperContentWrapper 和回调处理程序来增强元素管理,从而改善结构和焦点处理

范围: menu作者: soybeanjs查看提交d1596

重构

更新 MenuContent 以使用 MenuContentPrivateProps,并通过 elRef 增强元素转发功能

范围: menu作者: soybeanjs查看提交2e946

重构

将 SELECTION_KEYS 的导入移至常量中,以改善组织结构并确保各组件间的一致性

范围: menu作者: soybeanjs查看提交a4d33

新功能

实现带有上下文管理、导航和无障碍功能的菜单组件结构

范围: menu作者: soybeanjs查看提交e27d7

新功能

新增 MenuSubTrigger 组件,并更新 MenuRoot 的 props 以增强功能

范围: menu作者: soybeanjs查看提交c3b85

新功能

添加菜单组件名称

范围: menu作者: soybeanjs查看提交58293

新功能

将 MenuLabel 替换为 MenuGroupLabel,并为菜单组件添加主题上下文支持

范围: menu作者: soybeanjs查看提交02a5b

修复

更新可关闭层以使用 contentElement,并通过新的辅助函数改进焦点处理

范围: menu作者: soybeanjs查看提交9cbc7

修复

更新筛选逻辑,仅包含常用插槽

范围: menu作者: soybeanjs查看提交b4810

修复

将 separatorProps 绑定到 MenuSeparator 以提升功能

范围: menu作者: soybeanjs查看提交da975

修复

调整菜单变体中内容的最小宽度,以优化布局

范围: menu作者: soybeanjs查看提交50e8b

重构

移除未使用的 useCollection 可组合函数,并整合 useHideOthers 以实现更好的焦点管理

范围: menu作者: soybeanjs查看提交6a02b

重构

简化上下文管理,并增强菜单组件间的元素处理能力

范围: menu作者: soybeanjs查看提交976cf

重构

通过集成 PopperContentWrapper 和回调处理程序来增强元素管理,从而改善结构和焦点处理

范围: menu作者: soybeanjs查看提交d1596

重构

更新 MenuContent 以使用 MenuContentPrivateProps,并通过 elRef 增强元素转发功能

范围: menu作者: soybeanjs查看提交2e946

重构

将 SELECTION_KEYS 的导入移至常量中,以改善组织结构并确保各组件间的一致性

范围: menu作者: soybeanjs查看提交a4d33