SuperAPI AI 工具集

form-validation

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:在表单中实现一致的校验规则与错误体验,包括必填、格式、范围校验,错误提示与无障碍,提交门控(禁用状态、防重复提交),以及适用的服务端错误处理与映射。

输入:表单位置(路由/组件);字段与约束(必填/可选、格式、最小/最大值);提交行为(创建/更新、是否允许乐观更新);错误处理期望(行内、toast 或汇总);仓库配置(建议提供 <repo>/REPO_PROFILE.json,含表单库与模式)。

输出:符合仓库约定的校验规则(基于 schema 或命令式);错误 UI,包括字段级错误与表单级错误(提交失败);提交安全,包括提交时禁用与防止重复提交;可选推荐为校验行为添加测试。

非目标:不更改后端契约;不实现必须服务端强制的领域规则(仅在客户端镜像);不重新设计表单 UI。

工作流:识别仓库表单模式(原生、react-hook-form、formik、自定义、schema 校验器);实现校验,仓库使用 schema 时优先 schema,规则尽量靠近字段定义;接入错误 UX,字段错误显示在输入附近,提交错误显示在一致位置;确保无障碍,标签关联,适当时用 aria-describedby 关联错误文本;确保提交安全,挂起时禁用提交并防止重复触发;映射服务端错误,区分字段错误与全局错误,不安全时不泄露原始服务端消息;按配置运行校验,仓库期望时添加测试。

检查:无效输入被阻止或明确报错;所有交互字段有标签与可访问错误文本;提交不可重复触发;错误状态确定(无闪烁、无残留错误);如配置则类型检查、lint、测试通过。

失败模式:校验来源不明确时,建议使用共享 schema 类型并镜像规则;UX 模式冲突时,遵循仓库既有标准并记录偏差;服务端错误映射未知时,按全局错误处理并记录后续跟进。

遥测记录:skill: frontend/form-validation、fields_count、validation_style(schema/imperative/library)、tests_added(yes/no)、files_touched、outcome(success/partial/blocked)。