更新日志
用全局视角查看最近版本、受影响组件与升级入口,再按需跳回具体组件文档处理升级细节。
先看最新发布,再在升级路径跨越多个 tag 时补看更早版本,避免在完整 changelog 里来回搜索。
只看你实际使用到的组件相关版本,再从命中的条目直接跳回对应组件文档。
隐藏 docs、deps、workflow 等共享范围的非组件变更。
每个版本卡片都会汇总已发布条目、受影响组件,以及跳回组件文档的最快入口。
2026-10-02
本次发布更换了全部三个引擎,并重命名了两个组件系列。日期引擎从 @internationalized/date 迁移至 date-fns,并采用原生 Date 值;表格引擎基于 @tanstack/vue-table 重新构建(采用 TanStack 的列/状态命名规范,不再使用旧版别名); 表单引擎基于 @tanstack/vue-form 重构(useForm 返回一个上下文对象,initialValues 改为 defaultValues)。NavigationMenu 已移除,改用 NavMenu; SDrawer 更名为 SSheet,而 SBottomSheet 则成为新的手势驱动型 SDrawer;仅用于展示的无头组件家族(card/empty/list/skeleton/badge/tag)已被移除,且 SPopper/SArrow 不再从 UI 包中导出。 SPagination 的 actionAsSelected 属性更名为 actionVariant(语义和默认值保持不变)。请参阅升级指南以获取完整的迁移指南。
查看升级指南日期组件(Calendar、DateField、DatePicker、TimeField 及其范围变体)现基于 date-fns 构建的原生 Date 值进行操作。专门的日期指南将 CalendarDate/Time/DateTime 值、日历运算以及格式化/解析映射到了新模型。
查看升级指南2026-09-14
该版本移除了已发布的外围包 @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
该版本带来了重建的主题系统和包重命名。@soybeanjs/shadcn-theme 已改名为 @soybeanjs/theme(createShadcnTheme → createTheme),@soybeanjs/unocss-shadcn 已改名为 @soybeanjs/ui-uno(presetShadcn → presetUi,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
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-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
2026-04-27
2026-04-27
2026-04-27
2026-04-26
本版本包含 2 项破坏性变更,升级前请先阅读。
2026-04-03
2026-03-22
2026-03-21
2026-03-21
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
为下拉菜单组件添加 popupProps 以增强功能
查看提交ab340为上下文菜单组件引入 popupProps 以增强功能
查看提交e7289完整 changelog 中还有 47 条变更
2025-12-09
本版本包含 1 项破坏性变更,升级前请先阅读。
更新分页变量中选定按钮状态的边框样式
查看提交e817f调整列表变量中的填充,改进布局
查看提交88be2完整 changelog 中还有 13 条变更
2025-12-09
2025-11-19
2025-11-19
2025-11-19
2025-11-18
本版本包含 2 项破坏性变更,升级前请先阅读。