SuperAPI AI 工具集

w-form

前端与建站

查看项目

更新于 10-15 15:13

技能介绍

用途

w-form 用于在当前的 Next.js 应用中实现表单。它的核心原则是:遵循应用已有的数据变更路径,而不是引入第二套技术栈。技能描述明确指出,要“使用应用现有的 mutation 路径构建 Next.js 表单,而不是第二套技术栈”。

主要能力

  • 在当前 Next 应用中实现表单,遵循 next-v16 与 shadcn-v3。
  • 若应用已经通过 API 客户端(Fastify + TanStack Query)进行 mutation,则不要为这些流程引入 Server Actions、useFormStatus 或 useOptimistic。
  • 检查相邻表单如何提交,并复用该路径。
  • 使用同一份 Zod schema 支撑客户端用户体验与服务端校验。
  • 借助现有 UI 原语接入可访问的标签、错误、pending 以及空/错误/成功状态。
  • 运行 lint,并验证提交、校验失败与键盘操作路径。

使用方式

技能文本给出的执行流程为:先检查相邻表单的提交方式并复用同一路径;再共享一份 Zod schema 用于客户端与服务端;随后用现有 UI 原语接线可访问的标签、错误、pending 及空/错误/成功状态;最后运行 lint 并走查提交、校验失败和键盘路径。若行为或命令发生变化,需参考文档路径 /w-docs。

适用场景

适用于在既有 Next.js 应用中新增或改造表单,尤其是应用已有明确 mutation 路径(例如通过 API 客户端进行数据变更)时。此时该技能的作用是让新表单与现有架构保持一致,避免重复造栈。

限制

资料未提供关于收费、价格、平台支持范围、具体效果或其他使用步骤的更多细节,这些内容暂未提供。