Blackwork
回到顶部

Form

把 TanStack Form 接到 Blackwork 字段上。

Form

blackwork/form 把 TanStack Form 接到 Field 上。

先安装对等依赖：

Bash
pnpm add @tanstack/react-form

适用场景

  • 真正要提交、要有值和校验的流程
  • 复用 TextField、TextareaField、CheckboxField

如果只是一个带标签的输入，用 Field。

用法

用法

示例

内置字段

内置字段

Optional. Shown on your public profile.

自定义字段

Select、Combobox 等没有预绑定。在 form.AppField 里用 Field 自己组合。

自定义字段

API 参考

属性类型默认值说明
form必填{ handleSubmit: () => unknown }—useAppForm 返回的表单实例，Form 必填。
label必填ReactNode—TextField、TextareaField 和 CheckboxField 的可见标签。
descriptionReactNode—显示在控件下方的帮助文字。

说明

  • Form 会帮你调用 form.handleSubmit()。
  • SubmitButton 跟随 isSubmitting，并使用 Button 的 loading。