UI 视觉设计 / 系统课时
规范对话框焦点与关闭行为
规范对话框焦点与关闭行为
对话框从打开到关闭,键盘焦点必须有确定的起点、活动范围和返回位置。本课用“编辑项目名称”和“删除项目”两个场景,规定初始焦点、Esc 与关闭按钮的语义、底部按钮顺序,以及触发控件消失时的焦点返还规则。
学习目标
- 为编辑、长内容与危险确认对话框指定合理的初始焦点。
- 统一 Tab、Shift+Tab、Esc、关闭按钮和确认取消的交互结果。
- 为关闭后的焦点返还编写可复现的键盘验收用例。
先约束模态对话框的焦点范围
“编辑项目名称”和“删除项目”都采用模态对话框:打开后背景内容不可点击、不可聚焦,键盘只能操作当前最上层对话框。Web 组件应提供可见标题,并使用 role="dialog"、aria-modal="true"、aria-labelledby 指向标题;只有简短、可直接朗读的说明才适合关联 aria-describedby。
Tab 按可操作控件的顺序前进,到最后一个控件后回到第一个;Shift+Tab 反向循环。被禁用、隐藏的控件不参与循环。焦点环必须可见,不要把焦点留在遮罩、背景或不可识别的整个弹窗容器上。
按任务设定初始焦点
| 场景 | 打开时聚焦 | 验收依据 |
|---|---|---|
| 编辑项目名称 | “项目名称”输入框 | 可立即输入,不必先按 Tab |
| 删除项目(不可撤销) | “取消”按钮 | 按 Enter 不会误删 |
| 仅有简短结果提示 | “知道了”按钮 | 可直接确认并关闭 |
| 含多段说明、需要先阅读 | 顶部标题,设置 tabindex="-1" |
标题和正文开头不被滚出视野 |
例如,宽 480px 的编辑弹窗包含右上角“关闭”、项目名称输入框、底部“取消”和“保存”。视觉顺序与键盘顺序要可预测;初始焦点在输入框,按 Tab 依次到“取消”“保存”“关闭”,再回到输入框。标题使用程序化聚焦时,不要把它增加到常规 Tab 序列。

统一关闭入口与按钮次序
本规范约定底部左侧为“取消”、右侧为“保存”或红色“删除”,右上角提供带可访问名称“关闭对话框”的关闭按钮。“取消”、关闭按钮和 Esc 都调用同一套关闭检查,而不是分别维护三种结果;默认不允许点击遮罩关闭编辑或删除弹窗。
| 当前状态 | Esc / 关闭 / 取消 | 主要操作 |
|---|---|---|
| 编辑但未修改 | 直接关闭,不提交 | “保存”提交有效数据 |
| 编辑且有未保存修改 | 打开“放弃未保存修改?”确认层 | “保存”成功后关闭 |
| 删除确认 | 关闭并取消删除 | “删除”执行不可撤销操作 |
点击“保存”后若校验失败,不关闭弹窗,而是聚焦首个错误字段,并显示与字段关联的错误说明。提交期间应防止重复提交;是否允许关闭,必须依据请求能否安全取消制定明确规则。
有二次确认层时,Esc 只关闭最上层确认层,返回仍打开的编辑弹窗,不能一次关闭两层。删除确认框的初始焦点保持在“取消”上,不以 Enter 作为无条件删除快捷键。
关闭后把焦点还给可继续操作的位置
打开前记录触发控件。若“编辑名称”保存或取消后按钮仍在页面、可见且可用,关闭后焦点返回这个按钮,不应落到页面顶端或 body。关闭动画结束、背景恢复可交互时,返还必须已经完成。
若确认删除后原行被移除,不能对已卸载的“删除”按钮聚焦。项目列表约定按以下优先级选择替代目标:
- 下一条项目的“更多操作”按钮。
- 若没有下一条,上一条项目的“更多操作”按钮。
- 若列表已空,列表标题(用
tabindex="-1"程序化聚焦)或“新建项目”按钮。
焦点返还依照完成后的实际页面结构判断,而不是仅保存一个可能失效的 DOM 引用。
用键盘完成验收
- 仅用键盘定位“编辑名称”并按 Enter:对话框出现,项目名称输入框获得可见焦点环。
- 连续按 Tab 与 Shift+Tab:焦点只在弹窗控件中循环,不能进入背景项目列表。
- 修改名称后按 Esc:出现放弃修改确认层;再按 Esc 只关闭该层,编辑弹窗仍在,输入内容未丢。
- 再次触发关闭,选择“放弃修改”:返回原“编辑名称”按钮;重新编辑并保存成功也返回该按钮。
- 打开删除确认,按 Enter:初始焦点在“取消”,项目不会被删除;随后通过明确操作完成删除,焦点落到下一条项目的“更多操作”,或上述回退目标。
- 模拟保存校验失败:弹窗保持打开,首个错误字段获得焦点,错误信息可被关联读取。
Web 端可对照 WAI-ARIA APG 模态对话框模式 检查焦点循环、Esc 及焦点返还;把这些规则同时写入组件说明和键盘回归用例。