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

Form

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

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

快速跳转

同分类组件

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

更新日志

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

v0.50.0

2026-10-02

对比版本

新功能

在行发生变化时折叠表单字段数组内容的高度

范围: form作者: soybeanfe查看提交0c763

优化

将 array-row collapse 提取到 useCollapseHeight 可组合函数中

范围: form作者: soybeanjs查看提交58fe3

重构

将自动触发的错误动画替换为基于存在状态的过渡效果

范围: form作者: soybeanfe查看提交acb5b

重构

恢复高度折叠时的错误过渡效果

范围: form作者: soybeanfe查看提交e8fd3

重构

用 @tanstack/vue-form 替换自研表单引擎

范围: form作者: soybeanjs查看提交2568a

重构

基于 TanStack-native 合约和双源推理重构 useForm

范围: form作者: soybeanjs查看提交575dc

维护

将 setTimeout 替换为轮询机制,用于异步验证检查

范围: form作者: soybeanjs查看提交bf551

新功能

在行发生变化时折叠表单字段数组内容的高度

范围: form作者: soybeanfe查看提交0c763

优化

将 array-row collapse 提取到 useCollapseHeight 可组合函数中

范围: form作者: soybeanjs查看提交58fe3

重构

将自动触发的错误动画替换为基于存在状态的过渡效果

范围: form作者: soybeanfe查看提交acb5b

重构

恢复高度折叠时的错误过渡效果

范围: form作者: soybeanfe查看提交e8fd3

重构

用 @tanstack/vue-form 替换自研表单引擎

范围: form作者: soybeanjs查看提交2568a

重构

基于 TanStack-native 合约和双源推理重构 useForm

范围: form作者: soybeanjs查看提交575dc

维护

将 setTimeout 替换为轮询机制,用于异步验证检查

范围: form作者: soybeanjs查看提交bf551

v0.40.0

2026-09-14

对比版本

样式

更新横向布局的控制类

范围: form作者: soybeanjs查看提交9d536

v0.18.0

2026-05-05

对比版本

新功能

实现 Compact 组件

范围: form作者: soybeanjs, soybeanfe, Copilot查看提交95c48

v0.15.0

2026-04-26

对比版本

修复

更新模式验证的表单输入和输出类型

范围: form作者: soybeanjs查看提交3b792

修复

更新模式验证的表单输入和输出类型

范围: form作者: soybeanjs查看提交3b792

v0.10.2

2026-03-06

对比版本

修复

更新标签样式以防止文本包边

范围: form作者: soybeanjs查看提交2bbce

v0.10.0

2026-03-06

对比版本

优化

简化 formVariants 中的内联字段样式

范围: form作者: soybeanjs查看提交bafd3

v0.9.4

2026-03-05

对比版本

优化

优化表格变体

范围: form作者: soybeanjs查看提交5e736

v0.9.3

2026-03-05

对比版本

新功能

添加导出 SFormFieldBase 组件

范围: form作者: soybeanjs查看提交c0ee8

v0.9.2

2026-03-05

对比版本

新功能

添加 FormControl 组件并更新表单结构

范围: form作者: soybeanjs查看提交58c98

v0.0.11

2026-01-08

对比版本

修复

使用更多类型扩展窗体组件导出,提高类型安全性和灵活性

范围: form作者: soybeanjs查看提交9b8e0

v0.0.10

2026-01-07

对比版本

新功能

为表单组件导出添加 FormResetState 类型,以加强表单状态管理

范围: form作者: soybeanjs查看提交57e07

重构

重组表格组件

范围: form作者: soybeanjs查看提交1af2b

v0.0.2

2025-11-18

对比版本

新功能

实现用于字段名称生成和值解析的表单辅助函数

范围: form作者: soybeanjs查看提交373f1

新功能

扩展 parsePrimitiveValue 和 isPrimitive 以处理 null 和 undefined 值

范围: form作者: soybeanjs查看提交b3b52

新功能

实现用于字段名称生成和值解析的表单辅助函数

范围: form作者: soybeanjs查看提交373f1

新功能

扩展 parsePrimitiveValue 和 isPrimitive 以处理 null 和 undefined 值

范围: form作者: soybeanjs查看提交b3b52