更新日志
用全局视角查看最近版本、受影响组件与升级入口,再按需跳回具体组件文档处理升级细节。
先看最新发布,再在升级路径跨越多个 tag 时补看更早版本,避免在完整 changelog 里来回搜索。
只看你实际使用到的组件相关版本,再从命中的条目直接跳回对应组件文档。
隐藏 docs、deps、workflow 等共享范围的非组件变更。
每个版本卡片都会汇总已发布条目、受影响组件,以及跳回组件文档的最快入口。
2026-09-11
该版本移除了已发布的外围包 @soybeanjs/ui-x、@soybeanjs/admin 和 @soybeanjs/chart。在 headless 中,RovingFocusGroup/RovingFocusItem 组件被 useRovingFocusGroup/useRovingFocusGroupItem 组合式函数取代,PropsToContext 改名为 ToContext,transformPropsToContext 改为 toContext 且函数值不再需要调用。STable 默认不再带圆角,headless 组件也停止注入全局辅助类。完整迁移步骤请查看升级指南。
查看升级指南2026-08-31
本版本包含 1 项破坏性变更,升级前请先阅读。
2026-08-20
2026-08-20
2026-08-19
2026-08-19
该版本带来了重建的主题系统和包重命名。@soybeanjs/shadcn-theme 已改名为 @soybeanjs/theme(createShadcnTheme → createTheme),@soybeanjs/unocss-shadcn 已改名为 @soybeanjs/ui-uno(presetShadcn → presetUiUnocss,ShadcnPresetOptions → UiUnocssOptions)。已移除主题的 menu 配置(menuColor / menuAccent),自定义颜色覆盖改用 `overrides: { light, dark }` 取代旧的 preset 对象(也可通过 SConfigProvider 的 `theme.preset` 传入 preset)。请相应更新你的依赖与导入。
2026-06-22
集成 useStyleTag 以实现动态 CSS 处理
查看提交600c3将徽标源更新为远程 URL,并优化 SVG 设计
查看提交c6050更新生成的选项类型并改进配置处理
查看提交0be4d在 uno.config.ts 中设置格式预设以提高可读性
查看提交97d862026-06-20
2026-06-19
2026-06-18
import updateUiAttribute from shadcn-theme
查看提交6679f清理导入语句并移除未使用的默认预设选项检查
查看提交2b18c通过活动触发元素增强视口定位,并添加过渡效果
查看提交02dfc简化主题处理并改进 CSS 生成
查看提交11aff完整 changelog 中还有 83 条变更
2026-06-18
2026-06-18
2026-06-17
2026-06-17
2026-06-15
import updateUiAttribute from shadcn-theme
查看提交6679f更新 sbean 注册表
查看提交fb31b添加对 Nuxt 3 项目初始化的支持
查看提交5ac6c修正 useConfigProvider 的导入路径
查看提交7ad9c完整 changelog 中还有 4 条变更
2026-06-14
处理 generateRadiusCSSVariable 中半径值的回退逻辑
查看提交e723a简化主题处理并改进 CSS 生成
查看提交11aff完整 changelog 中还有 14 条变更
2026-06-12
2026-06-10
2026-06-10
通过活动触发元素增强视口定位,并添加过渡效果
查看提交02dfc更新类型导入,在所有组件中移除 .js 扩展名
查看提交c43e82026-06-10
2026-05-30
2026-05-29
2026-05-28
2026-05-28
2026-05-28
2026-05-28
2026-05-28
2026-05-28
2026-05-27
2026-05-26
2026-05-23
2026-05-22
2026-05-20
2026-05-19
2026-05-19
为各种软件包添加 minimumReleaseAgeExclude 条目
查看提交009d42026-05-19
2026-05-19
2026-05-19
2026-05-18
2026-05-17
2026-05-17
2026-05-14
2026-05-13
2026-05-12
2026-05-12
2026-05-11
2026-05-05
2026-05-03
移除未使用的 useStyleTag,并将 cssVars 整合到原始码中
查看提交3996e为 PopoverRoot 添加禁用道具并更新测试选择器
查看提交1cce9完整 changelog 中还有 33 条变更
2026-05-01
2026-04-30
2026-04-30
实施 BottomSheet 组件
查看提交fb274在配置提供程序中添加全局 css
查看提交b2a75简化配置提供程序和吐司提供程序中的样式处理
查看提交9ef672026-04-27
2026-04-27
2026-04-27
2026-04-26
本版本包含 1 项破坏性变更,升级前请先阅读。
2026-04-26
更新 sidebarWrapper 和轨道样式,以实现响应式布局
查看提交671802026-04-26
本版本包含 1 项破坏性变更,升级前请先阅读。
2026-04-18
2026-04-03
2026-03-22
2026-03-21
2026-03-21
2026-03-20
2026-03-20
2026-03-20
2026-03-07
2026-03-07
2026-03-07
2026-03-07
本版本包含 2 项破坏性变更,升级前请先阅读。
完整 changelog 中还有 1 条变更
2026-03-06
2026-03-06
2026-03-06
2026-03-06
2026-03-06
2026-03-06
2026-03-06
2026-03-06
2026-03-05
2026-03-05
2026-03-03
2026-03-01
本版本包含 1 项破坏性变更,升级前请先阅读。
2026-02-11
2026-02-10
2026-02-09
2026-02-09
利用 useStorage 加强主题变量管理
查看提交1a002更新全局窗口属性以使用 \__SoybeanUI_ 前缀
查看提交0e3d42026-02-08
2026-02-08
2026-02-07
2026-02-07
2026-02-06
2026-02-05
2026-02-05
2026-02-04
2026-02-04
2026-02-03
2026-02-01
2026-01-30
2026-01-29
2026-01-29
2026-01-29
2026-01-28
2026-01-28
2026-01-28
2026-01-28
2026-01-28
2026-01-28
2026-01-27
2026-01-27
2026-01-27
2026-01-27
2026-01-27
2026-01-26
2026-01-23
2026-01-22
2026-01-21
2026-01-19
2026-01-19
完整 changelog 中还有 6 条变更
2026-01-14
2026-01-14
2026-01-09
2026-01-08
2026-01-08
2026-01-07
2026-01-02
完整 changelog 中还有 2 条变更
2026-01-01
增加对水平和垂直方向的支持,更新示例和文档
查看提交30ba7为下拉菜单组件添加 popupProps 以增强功能
查看提交ab340为上下文菜单组件引入 popupProps 以增强功能
查看提交e7289完整 changelog 中还有 47 条变更
2025-12-09
本版本包含 1 项破坏性变更,升级前请先阅读。
更新分页变量中选定按钮状态的边框样式
查看提交e817f调整列表变量中的填充,改进布局
查看提交88be2完整 changelog 中还有 13 条变更
2025-12-09
2025-12-07
2025-11-23
2025-11-19
2025-11-19
2025-11-19