第 4 章 页面交互:动作发生后应该显示什么
4.1 四种状态缺一不可
图解:同一个操作,要把四种状态说清楚
读图: 四个框表示不同状态,不是必须依次经过的四个步骤。空状态不是报错,接口返回成功也不能替代用户真正拿到结果。
- 加载中:告诉用户正在发生什么,耗时较长时给进度或可取消入口。
- 空状态:明确为什么还没内容,并给一个下一步,例如“添加第一条计划”。
- 错误状态:说明哪里失败、是否能重试,不把内部 Schema 或异常堆栈直接给普通用户。
- 成功状态:真正出现了可继续操作的结果,不只是后台日志说“成功”。
真实旧例:学习平台创建试卷后,后台有成功记录,但页面没有“开始作答”按钮。说明工具成功 ≠ 用户能完成流程;页面必须实际渲染下一步。
动态选择题和语音记账的案例见附录 A.4.1、A.4.2。
4.2 弹窗、抽屉和底部弹层怎么选
危险或不可逆操作才需要强确认弹窗;少量选项可用抽屉或底部弹层,普通成功提示不必打断用户。打开弹层时,还要处理焦点、滚动、取消、返回和关闭。
真实踩坑(2026-07): 交卷提交成功后,页面已经跳转,“确认交卷”弹窗却仍盖在页面上。命令式弹窗由独立容器管理,异步提交后若先导航、卸载原页面,关闭动作可能失效。曾尝试手动销毁和延迟跳转,最后改为受控弹窗,并按“提交成功 → 关闭弹窗 → 跳转”执行。交卷验收要覆盖成功状态、结果页数据、遮挡层关闭与防重复提交。
命令式弹窗并非一概错误;关键是明确谁管理它的生命周期,以及提交失败、取消和跳转时如何收尾。完整排查见《前端工程实践》。
点击日历被强制滚走的案例见附录 A.4.3。
浮窗显示、键盘焦点和采纳各有状态(待学习)
建议可以停笔后出现,继续输入仍应送回原控件。文字变化后立即撤掉旧预览,迟到的结果按控件和原文快照核对。预览可以用红删绿增画出语序搬移,但逐条采纳时要把这次搬移作为一个整体,避免只删一半。验证时分别试继续打字、鼠标采纳、快捷键和旧响应迟到。
4.3 反馈还要覆盖手机操作
电脑鼠标有悬停(hover),手机主要靠点击、触摸和手势,不能只给 hover 动效。按钮要有点击反馈,键盘操作要有焦点提示,加载或失败状态不能挡住“返回”和“重新尝试”。
4.4 受控组件:为什么直接改输入框文字没用
我曾遇到:测试面板的字段看似可以用脚本直接改,但 React 重新渲染就恢复原值;原因是受控组件实际由 state 决定,DOM 上暂时可见的值不代表发出的请求真的改变。
旧实验在有权限的测试环境里临时构造过“去掉输出 Schema”的请求对照,帮助检验模型行为。这不等于前端产品已经提供该功能,更不应该作为生产环境绕过权限、用户确认或业务约束的办法。长期可维护的测试应提供明确参数入口或 Mock,并核对真正发出的载荷、服务端处理和最终 UI。
**“取消编辑”却触发保存,是事件顺序问题。**个人工作台用输入框失焦 blur 自动保存,但用户按“取消”时,mousedown/焦点变化先触发保存,按钮的 click 才执行取消。设计时要明确取消的优先级,保存失败保留草稿,并从网络请求而非页面文字验证是否真的写入;受控输入和防抖也不能代替服务端确认。
能读、能定位、能写和写入已确认各测一次(待学习)
桌面输入框可能允许读取和设置选区,却不允许写入选中的文字。分别探测正文、坐标、选区、局部和整体写入能力,再选写入方式。范围使用 UTF-16 时,写前核对同一个输入框、完整原文、原始编码单元与目标片段。看起来相同的组合字符可能长度不同,旧建议应过期。
发出粘贴或替换后,再读实际正文。只有读回匹配预期,才记采纳和更新缓存。可以用一个收到粘贴事件但故意不更新文本的合成编辑器验证失败路径。真实 App 的授权和兼容性用安装后的正常启动路径另验。
UTF-16 选区记录 · 输入框能力探测 · 未确认写入的反例
复用时仍需核对的边界(待学习)
输入框可读、范围可定位、选区可设置、局部可写、整体可写分别探测。某次微信探测只有整体写可用,不能据此视为不支持读取;整体替换仍须全文保护。终端进程 AX trusted 也不能代替正常启动 App 的授权。实际目标 App 的兼容采纳仍待验证。
4.5 中文输入法和流式工具状态是两个不同的协议边界
旧学习平台有过“用户正在拼音选词,按 Enter 却把半句话发出去”的问题。文本框里出现字母不代表输入法已经完成组合:监听 compositionstart、compositionend 与 Enter 事件,正常确认候选字时不提交;组合真正结束、下一次按 Enter 才执行发送。不能只凭英文键盘的自动化测试说中文输入正常。移动输入法和不同浏览器还需要真实测试。
另一类问题是流式工具调用:用户等待很久只看到“思考中”,开发时想尽早展示准备状态,但还没完整到齐的工具参数不能提前作为正式 tool_call 发布。应将 status/tool_preparing 这种用户可读的阶段提示与参数完整、通过 Schema 的真实 ToolCall 分成两种事件;如果 UI 把两者当同一动作,可能出现解析半段 JSON、重复工具卡或虚假进度。
最低验收:真实中文 IME 拼字/选词/换行;发送后短时间能看到有意义状态;工具准备中不产生真实业务副作用;完整调用到达后只展示一张卡。2026-08-25 的交接只证明完成了只读定位和制定修复方向,不能据此认定最终代码已部署。
来源:旧 AI 任务交接 40-AI任务交接/2026/08/25-知了-XCC对话响应与输入法修复.md。
“工具正在准备”的计时起点案例见附录 A.4.4。
AI 对话的操作范围(2026-11-04,待学习):生成回复时允许准备下一条草稿,明确显示停止生成;失败重试和成功后的重新生成分开。对旧消息重新生成,若会影响后续对话,要先说明范围。复制选中文字和操作整条消息用不同入口;“在线”应来自真实连接状态,不能固定显示。长输入逐步长高,到上限后内部滚动,失败保留草稿。以上是历史界面复盘提炼的检查点,未据此修改当前产品或验证实现。
4.6 半选状态用组件接口,别强转原生 input(待学习)
第三方选框可能渲染成 button,直接改 ref.indeterminate 无效。先看 DOM 和组件契约,传明确的半选状态,同时检查横杠、颜色和 aria-checked=mixed。验未选、已选、半选、禁用、深浅色及键盘,深色边框别与行底色混在一起。
来源与当时边界
4.7 currentScript 可就地渲染,异步先保存引用(待学习)
普通脚本可通过 document.currentScript 找到自身,用 replaceWith 换成文本或 DOM,适合静态页小部件;不适用于 type=module,异步回调先保存引用。原文已更正“不能异步取数”,阅读时看后续修正。内联脚本受 CSP 约束,外部文本优先建文本节点,不直接拼 outerHTML;尚未浏览器实测。