用途:该技能面向 Nuxt 项目中的表单处理,覆盖创建表单、校验错误展示、表单状态管理以及表单类界面构建。资料将其分为两部分:forms.md 面向后台与 SaaS 应用,介绍 XForm、useFormBuilder 与校验模式;marketing-forms.md 面向公开的多步表单,不使用 XForm,而是在客户端与服务端之间共享 Zod schema(放在 shared/utils/),并涉及 Turnstile 隐形模式与 token 等待、蜜罐与 IP 限流、UForm 提交按钮的模板引用触发问题,以及 chip-toggle 组件模式。
主要能力:XForm 组件通过 url、method、data、waiting 等属性发起提交,并提供 submit、success、error 事件;表单数据用 ref 定义,提交时调用对应 action。校验错误可通过 form.errors.has、first、get、any 读取,并在 UFormField 的 error 属性中展示。
使用方式:在模板中放置 XForm,内部使用 UFormField 与 UInput 绑定数据,通过 #actions 插槽放置提交按钮并绑定 loading 状态;脚本中定义 formData 与 onSubmit、onSuccess 等回调。
适用场景:后台管理、SaaS 应用表单,以及需要客户端与服务端共享校验规则的公开多步表单。
限制:资料未提供安装命令、依赖版本、收费信息与完整 API 说明,部分细节需参考原始技能文件。