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

SoybeanUI

v0.50.0
组件
返回目录
组件详情入口
导航
@soybeanjs/ui
STreeMenu

TreeMenu

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

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

快速跳转

概述用法演示API更新日志

同分类组件

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

AnchorBreadcrumbCommandContextMenuDropdownMenuMenu

更新日志

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

v0.50.0

2026-10-02

对比版本

新功能

使样式化项具有多态性并能感知状态

范围: tree-menu作者: soybeanjs查看提交83a4f

样式

当侧边栏折叠时，调整项目行宽度

范围: tree-menu作者: soybeanjs查看提交95c3f

文档

将生成的技能与当前示例保持同步

范围: tree-menu作者: soybeanjs查看提交6e7c1

样式

当侧边栏折叠时，调整项目行宽度

范围: tree-menu作者: soybeanjs查看提交95c3f

文档

将生成的技能与当前示例保持同步

范围: tree-menu作者: soybeanjs查看提交6e7c1

新功能

使样式化项具有多态性并能感知状态

范围: tree-menu作者: soybeanjs查看提交83a4f

v0.40.0

2026-09-14

对比版本

新功能

折叠式下拉弹出窗口的键盘导航

范围: tree-menu作者: soybeanfe查看提交c2a44

修复

从 dropdownMenuProps 中获取折叠下拉菜单的展开状态

范围: tree-menu作者: soybeanfe查看提交e94f0

新功能

折叠式下拉弹出窗口的键盘导航

范围: tree-menu作者: soybeanfe查看提交c2a44

修复

从 dropdownMenuProps 中获取折叠下拉菜单的展开状态

范围: tree-menu作者: soybeanfe查看提交e94f0

v0.31.0

2026-08-31

对比版本

优化

为 pxToRem 添加默认值

范围: tree-menu作者: soybeanjs查看提交abcf5

v0.30.0

2026-08-20

对比版本

新功能

新增 expandStrategy 属性，支持 keep 和 active 模式

范围: tree-menu作者: soybeanjs查看提交5d911

新功能

新增 expandStrategy 属性，支持 keep 和 active 模式

范围: tree-menu作者: soybeanjs查看提交5d911

v0.26.0

2026-05-27

对比版本

优化

增强树形菜单样式和组件中的工具提示和徽章集成

范围: tree-menu作者: soybeanfe查看提交07bc0

v0.19.0

2026-05-11

对比版本

新功能

实施 TreeMenuCmpact

范围: tree-menu作者: soybeanfe查看提交ccecd

v0.15.0

2026-04-26

对比版本

修复

修复树形菜单中的可折叠 UI 上下文

范围: tree-menu作者: soybeanjs查看提交fbb4b

修复

修复树形菜单中的可折叠 UI 上下文

范围: tree-menu作者: soybeanjs查看提交fbb4b

v0.7.0

2026-02-09

对比版本

重构

添加 TreeMenuOptions 组件并加强上下文管理

范围: tree-menu作者: soybeanjs查看提交4878f

v0.3.3

2026-01-30

对比版本

修复

为下拉菜单添加活动值绑定

范围: tree-menu作者: soybeanjs查看提交18f74

v0.3.0

2026-01-29

对比版本

新功能

实现活动路径跟踪和更新子活动状态逻辑

范围: tree-menu作者: soybeanjs查看提交6d5e8

优化

添加 getTreePaths 函数，并更新树形菜单组件以使用该函数

范围: tree-menu作者: soybeanjs查看提交c6391

v0.2.8

2026-01-28

对比版本

修复

更新 TreeMenuCollapsible 组件中的打开状态逻辑

范围: tree-menu作者: soybeanjs查看提交5e892

修复

在 TreeMenuOption 组件中添加选择-下拉事件发射功能

范围: tree-menu作者: soybeanjs查看提交7852c

v0.2.7

2026-01-28

对比版本

修复

确保在 filterHiddenMenus 函数中创建新的菜单对象

范围: tree-menu作者: soybeanjs查看提交5579b

v0.2.6

2026-01-28

对比版本

新功能

增强隐藏菜单的过滤逻辑，更新子菜单可见性检查

范围: tree-menu作者: soybeanjs查看提交4bd8a

v0.2.5

2026-01-28

对比版本

优化

为树形菜单中的尺寸变化调整间距和衬垫

范围: tree-menu作者: soybeanjs查看提交f9249

v0.2.4

2026-01-28

对比版本

修复

更新 hasChildren 计算，以排除隐藏的儿童

范围: tree-menu作者: soybeanjs查看提交f3343

优化

改进 TreeMenuOption 和 TreeMenu 中的儿童筛选逻辑

范围: tree-menu作者: soybeanjs查看提交7955e

v0.2.0

2026-01-28

对比版本

重构

重构类型定义并添加隐藏属性

范围: tree-menu作者: soybeanjs查看提交23110

v0.1.13

2026-01-28

对比版本

新功能

为树形菜单选项添加项目可见性控制

范围: tree-menu作者: soybeanjs查看提交70ac1

v0.1.12

2026-01-28

对比版本

优化

将 TreeMenuGroupOptionData 改为一种类型并删除多余属性

范围: tree-menu作者: soybeanjs查看提交40685

v0.1.10

2026-01-28

对比版本

新功能

添加 showGroupIcon 属性以控制组图标的可见性

范围: tree-menu作者: soybeanjs查看提交62193

新功能

使用新道具增强 TreeMenuOption，以便更好地定制

范围: tree-menu作者: soybeanjs查看提交69033

v0.1.8

2026-01-27

对比版本

优化

移除未使用的 useTreeMenuUi 导入并重构样式化项目组件

范围: tree-menu作者: soybeanjs查看提交7e505

v0.1.7

2026-01-27

对比版本

优化

更新 groupRoot 边距样式，使布局更合理

范围: tree-menu作者: soybeanjs查看提交e3fb2

v0.1.5

2026-01-27

对比版本

优化

从 TreeMenuRootProps 中移除未使用的 collapsedWidth prop

范围: tree-menu作者: soybeanjs查看提交7a4fd

v0.1.4

2026-01-27

对比版本

新功能

使用自定义属性扩展 TreeMenuOptionData 并更新类型定义

范围: tree-menu作者: soybeanjs查看提交12721

v0.1.3

2026-01-26

对比版本

新功能

使用计算类和道具接口增强 TreeMenuStyledItem

范围: tree-menu作者: soybeanjs查看提交c6bc8

v0.0.11

2026-01-08

对比版本

新功能

为 TreeMenuOption 添加 "as "道具并更新相关组件，以提高渲染的灵活性

范围: tree-menu作者: soybeanjs查看提交18c0f

v0.0.9

2026-01-02

对比版本

重构

实现无头 TreeMenu 组件，增强结构和样式，包括新的 TreeMenuOption 和 TreeMenuGroup 组件

范围: tree-menu作者: soybeanjs查看提交21708

v0.0.8

2026-01-01

对比版本

样式

为根样式添加边距重置，以提高布局一致性

范围: tree-menu作者: soybeanjs查看提交5ff20

v0.0.6

2025-12-09

对比版本

样式

增强下拉选择处理和更新类型定义，以实现更好的集成

范围: tree-menu作者: soybeanjs查看提交350ed

新功能

增强下拉选择处理和更新类型定义，以实现更好的集成

范围: tree-menu作者: soybeanjs查看提交350ed

v0.0.3

2025-11-19

对比版本

重构

改进项目操作定位和工具提示逻辑，提高可用性

范围: tree-menu作者: soybeanjs查看提交8fd11

重构

改进项目操作定位和工具提示逻辑，提高可用性

范围: tree-menu作者: soybeanjs查看提交8fd11

v0.0.2

2025-11-18

对比版本

新功能

实现具有折叠功能和可自定义项的 TreeMenu 组件

范围: tree-menu作者: soybeanjs查看提交5d47a

新功能

实现 TreeMenuItemWrapper 以复用 TreeMenuItem 的样式

范围: tree-menu作者: soybeanjs查看提交d1b8e

样式

增强 TreeMenuItem 的实现，改进属性处理和结构

范围: tree-menu作者: soybeanjs查看提交c5d34

样式

更新 TreeMenuItem 的样式，以提升可访问性并保持一致性

范围: tree-menu作者: soybeanjs查看提交9c465

样式

移除 TreeMenuItemImpl 组件，并将该组件的功能整合到 TreeMenuItem 中，以使结构更简洁

范围: tree-menu作者: soybeanjs查看提交60131

新功能

在树形菜单导出中添加 STreeMenuRootOption 组件

范围: tree-menu作者: soybeanjs查看提交405ca

新功能

实现具有折叠功能和可自定义项的 TreeMenu 组件

范围: tree-menu作者: soybeanjs查看提交5d47a

新功能

实现 TreeMenuItemWrapper 以复用 TreeMenuItem 的样式

范围: tree-menu作者: soybeanjs查看提交d1b8e

样式

增强 TreeMenuItem 的实现，改进属性处理和结构

范围: tree-menu作者: soybeanjs查看提交c5d34

样式

更新 TreeMenuItem 的样式，以提升可访问性并保持一致性

范围: tree-menu作者: soybeanjs查看提交9c465

样式

移除 TreeMenuItemImpl 组件，并将该组件的功能整合到 TreeMenuItem 中，以使结构更简洁

范围: tree-menu作者: soybeanjs查看提交60131

新功能

在树形菜单导出中添加 STreeMenuRootOption 组件

范围: tree-menu作者: soybeanjs查看提交405ca