SKILLπ JOURNAL ↗ 工作流

React 弹窗上线前,怎样验收键盘交互

用编辑资料弹窗核对 React 状态、焦点路径、提交失败和重复打开的行为。

在社区图书馆的预约页面上,读者点击“取消预约”后会看到一个确认框。截图看起来没有问题,但键盘用户打开后仍能进入背景的书目链接,提交失败后也找不到错误提示。这个案例适合把 React 组件边界、键盘交互和浏览器验收一起做。最终交付包括组件状态约定、可操作的预览、测试用例以及上线前的复核记录。

先约定组件的责任

预约列表持有当前选中的预约及更新结果,对话框负责标题、提示、两个动作和打开关闭时的焦点。网络请求由业务层发起,组件只根据明确的状态渲染。可以先画一张状态表,列出关闭、等待确认、提交中、提交失败、已完成,以及每个状态允许触发的动作。用 TypeScript 区分这些状态,例如只有失败状态携带错误信息,只有打开的状态才持有待取消的预约编号。不要用几个互不约束的布尔值表示同一流程,否则页面可能同时显示已完成与重试。

在评审组件 API 时,用两个入口试装。预约列表有多行按钮,取消成功后会移除触发按钮。预约详情页只有一个入口,取消后可能显示状态标签。两者应共享确认流程,但父页面分别提供焦点回退位置。测试先使用本地固定数据,再接入实际请求。请求尚未完成时应防止重复提交,并让读者知道操作仍在处理。若界面允许关掉等待中的对话框,先约定后台请求的结果将显示在哪里。

给键盘和辅助技术写具体预期

打开确认框后,让焦点进入可预期的位置。对于取消预约这种可能改变记录的操作,可以先聚焦“保留预约”。对话框应有读者能理解的标题和名称。背景内容在模态打开时应无法继续操作。用 Tab 和 Shift+Tab 分别检查焦点能在框内循环,检查 Escape 的行为与产品约定一致。关闭后通常回到触发按钮。如果成功后该按钮不再存在,焦点应移到下一条预约或列表标题。测试时从页面顶部用键盘进入这条路径,记录每一步实际的焦点元素。

用读屏软件复核打开、提交失败与关闭三个时刻。确认打开时能知道这是哪个预约的操作,失败时能知道问题和下一步,关闭后仍能定位到预约列表。视觉评审要覆盖焦点指示、文字与背景的明暗差,以及窄屏和放大后按钮是否还能看见。找不到焦点时先区分焦点确实跑到了背景,还是样式把轮廓隐藏了。这两种问题需要不同的修复。

把请求结果变成能重现的浏览器用例

给测试账号准备两条预约。第一条用于取消成功,第二条用于模拟服务器失败。成功用例从列表中按 Tab 找到第一条预约的取消按钮,按 Enter 打开确认框,再用键盘提交。断言请求只发出一次,原预约从列表移除,焦点落到约定的位置。这里既要检查界面结果,也要检查请求次数,否则快速按两次 Enter 可能造成两个请求,而界面看起来仍然正常。

失败用例拦截第二条预约的取消请求,第一次返回错误,第二次返回成功。断言第一次失败时对话框保持打开、预约仍在列表中,错误说明和重试入口可操作。重试前记录请求对应的预约编号,避免列表刷新后误取消另一条。用页面可观察的状态判断请求完成,例如按钮重新可用或错误提示出现。等待固定秒数容易让测试在慢机器上失败,也会在快机器上浪费时间。

定位元素时优先使用角色与可读名称。如果两个按钮都叫“取消预约”,先按书名找到那一行,再在行内找按钮。这样改变布局或替换样式类时测试依然能运行。组件测试负责检查状态分支和回调参数,浏览器用例覆盖焦点、真实页面滚动和请求衔接。把失败时的截图、焦点元素名称和请求次数一起保存,评审者就能区分问题来自组件还是服务。

用慢设备和长文案复核

拿包含长书名、两行说明及较长错误文本的样本,缩小到手机宽度。检查对话框内容能否滚动、动作区是否仍可抵达,以及弹窗打开后背景是否会随手势移动。用键盘在放大后的页面重复一次路径。如果操作按钮被虚拟键盘或固定底栏挡住,先检查容器高度和滚动归属,再调整样式。把同一场景放进测试夹具,后续改主题或调整间距时可以复用。

性能审查应从可以感知的动作开始。记录一次点击到对话框出现的过程,再看打开后第一次按键是否马上有反馈。若首次打开明显卡顿,用浏览器性能记录区分模块加载、列表重渲染和布局计算。举例说,弹窗状态改变时整张预约列表都重绘,先检查父组件的状态边界,再考虑缓存。复测时使用同一份预约数据和同样的设备设置,记录变更前后的结果。加载失败或缓存失效时也应让用户能回到列表。

按当前问题选择工具

如果预约取消要同时支持列表、详情页和管理员界面,先找能审查 React 与 TypeScript 状态边界的工具。给它三处入口和一张状态表,要求列出共享的业务规则、各页独有的行为,以及请求如何得到预约编号。验收时检查从列表切换到详情页后是否仍会引用旧选中项。若工作只涉及一个已有组件,提供组件调用示例和复现步骤,优先验证关闭行为与焦点回退,避免把无关页面也纳入改造。

对于无障碍工具,先给一个明确的失败案例,例如按 Shift+Tab 时焦点进入背景列表。要求输出复现步骤、实际焦点和建议修复位置。自动扫描结果可以帮忙发现缺少可访问名称和部分对比度问题,仍要用键盘和读屏验证动态状态。发现问题后在修复前保存失败路径,修复后沿同一路径确认差异。

浏览器测试工具需要能打开有测试数据的页面,也要能控制取消请求的响应。先试一个成功用例和一个失败用例,看输出是否同时包含交互结果和可重现条件。如果工具只交付截图,补充对焦点、响应和请求次数的断言。选型时查清支持的浏览器、可否运行在现有测试环境,以及失败记录保存在哪里;用同一测试账号并行运行时,为各用例准备不同预约,防止一个用例删除了另一个用例的数据。

放进上线检查的故障清单

按 Escape 后弹窗消失但焦点丢了怎么办?先确定触发按钮是否仍在页面。如果列表刷新已经移除了它,就检查父页面是否提供了可聚焦的回退位置。若按钮仍然存在,检查焦点恢复是否早于弹窗卸载,以及页面是否又重新渲染并替换了那个节点。

按钮一直显示处理中怎么办?查看浏览器请求是否结束,再检查界面是否收到了成功或失败状态。模拟服务器返回错误但响应格式不完整的情况,确认用户仍能看到可理解的提示。若预约已经在另一设备取消,应按实际结果刷新列表并给出说明,让用户可以离开对话框。

发布候选交给测试人员时,附上预览网址、虚构数据的初始化办法、浏览器与设备、组件状态表,以及每个用例预期留下的证据。先让一位未参与开发的同事独立完成取消、保留、失败重试和窄屏操作。只有测试步骤、组件状态和后台结果能对上,才把该版本标为验收通过。

增加一次并发变化演练

让测试人员同时打开两个窗口。在第一个窗口开启取消对话框,先不提交。在第二个窗口用同一个测试账号取消这条预约,再回到第一个窗口确认。前端需要根据服务端返回的实际状态刷新对应记录,并告诉读者这条预约已经取消。测试应同时观察列表、对话框、焦点和请求编号。如果界面刷新后还显示其他预约的取消提示,检查请求响应是否被错误地应用到了当前选中项。可以让异步处理在提交时保存预约编号,完成后按该编号更新列表。

再做一次路由切换演练。用慢响应延长等待时间,提交后转到预约详情页以外的页面,随后返回列表。记录应用是否按业务约定继续处理请求、回到列表时是否重新读取状态,以及迟到的响应会不会打开已经关闭的对话框。给这两项演练分别准备独立的测试数据。如果一次演练依赖另一项留下的状态,就把准备动作移入当前用例,以便在其他浏览器单独复现。

给评审留下能定位问题的证据

测试记录应包括构建版本、测试数据编号、输入动作、预期结果和实际结果。遇到只有特定浏览器出现的异常,先保存同一操作路径在正常和异常浏览器中的截图及焦点顺序,再确认是否使用同一份组件构建。缩小差异时优先查原生对话框、滚动容器和事件传播。复测要从入口重走整个场景,包括故障恢复和关闭后的下一次操作。把通过结果与原始问题放在同一条记录中,后续升级组件库时就能用相同场景比较。

用 React Best Practices 审查父组件的预约状态和请求边界,输入两个入口及状态表。用 Webapp Testing 在可访问的预览环境复测键盘、失败重试和焦点回退,提供独立的测试预约与预期结果。

分享文章X ↗LinkedIn ↗

CONTINUE YOUR WORKFLOW

把这篇教程,用到下一项任务。

按明确的技能关联与共同专题推荐;使用条件以详情和原始来源为准。