用途:在 Nuxt 项目中处理表单,涵盖表单创建、校验错误展示与表单状态管理,适合构建以表单为核心的交互流程。
主要能力:提供 XForm 组件与 useFormBuilder。XForm 支持通过 url、method、data、waiting 等属性提交数据,并暴露 submit、success、error 事件;配合 UFormField 的 name 与 error 属性展示字段级校验错误。表单对象提供 errors.has、errors.first、errors.get、errors.any 等方法读取错误,processing 表示处理状态。
使用方式:用 ref 定义表单数据对象,在 onSubmit 中调用提交动作,在 onSuccess 中处理成功回调;模板中通过 v-model 绑定输入,用 UButton 的 type="submit" 与 loading 控制提交按钮。
适用场景:创建表单、处理校验错误、管理表单状态、构建基于表单的页面或弹窗流程。
限制:资料未提供安装方式、依赖版本、完整 API 列表、服务端校验细节及平台兼容性说明。