SuperAPI AI 工具集

hwc-forms-validation

办公与效率

查看项目

更新于 10-16 00:01

技能介绍

用途:实现以表单为中心的 Hotwire 工作流,基于 Turbo Frames 与 Stimulus,覆盖创建/编辑、内联编辑、typeahead/autocomplete、模态表单与外部表单控件等场景。

核心流程:先识别表单流程类型;当校验错误需要就地重渲染时,用 Turbo Frame 包裹表单交互作用域;校验失败返回 422,成功重定向返回 303;仅在 Turbo 默认行为不足时,用 turbo:submit-end 处理提交后行为;重渲染时保留用户上下文(焦点、光标、选区)。

约束:输入状态保持单一数据源,避免在 frame 与非 frame DOM 中重复控件;渲染在目标 form 层级之外的控件应使用 HTML form 属性;避免在每次按键时触发提交逻辑而不加防抖/节流;当表单响应仅更新一个 frame 时,提交后行为要显式处理。

参考文档按需加载,仅打开当前请求所需文件,包括内联编辑、模态校验、typeahead 搜索、带焦点处理的 typeahead 校验、frame 中的外部表单控件、Stimulus 动作参数等;完整目录见 references/INDEX.md。

相关能力可交由邻近技能处理:导航/历史/缓存用 hwc-navigation-content;WebSocket 或 Turbo Stream 推送更新用 hwc-realtime-streaming;媒体上传/播放用 hwc-media-content;通用 UX 打磨用 hwc-ux-feedback;Stimulus API 设计问题用 hwc-stimulus-fundamentals。具体安装命令与收费等信息资料未提供。