浏览器与 Web API / 系统课时
键盘操作与焦点管理
键盘操作与焦点管理
键盘用户依靠 Tab、Shift+Tab、方向键和 Escape 完成交互。本课将建立可预测的焦点顺序,并通过一个原生对话框示例实现打开后移动焦点、关闭时恢复焦点以及无需鼠标的完整操作闭环。
学习目标
- 根据 DOM 顺序设计自然、连续的 Tab 导航路径。
- 正确使用
tabindex="0"与tabindex="-1"控制焦点移动。 - 在弹层打开和关闭时移动、限制并恢复焦点。
设计可预测的 Tab 顺序
浏览器默认按照 DOM 中可聚焦元素的先后顺序移动焦点,因此视觉布局与 DOM 顺序应保持一致。不要依靠 CSS 把按钮移动到与源码完全不同的位置,否则键盘焦点会在页面上看似随机地跳动。
原生按钮、链接和表单控件通常已经可以进入 Tab 顺序。普通元素只有在确有交互职责时才应增加 tabindex。tabindex="0" 会把元素放入自然顺序,tabindex="-1" 则允许脚本调用 focus(),但不会让用户通过 Tab 主动进入。
应避免使用大于零的 tabindex。正数会创建独立的优先级顺序,页面增加新控件后很难维护,也容易导致焦点顺序与阅读顺序不一致。
组织弹层的焦点生命周期
打开模态弹层时,焦点应从触发按钮移动到弹层标题、首个输入项或关闭按钮。弹层活动期间,背景区域不应继续接收交互;关闭后,焦点必须回到原来的触发元素,让用户能够从中断位置继续操作。

原生 <dialog> 通过 showModal() 打开时会让背景内容处于不可交互状态,并支持 Escape 关闭。脚本仍需保存触发元素,在打开后选择合适的初始焦点,并在 close 事件中完成恢复。
实现键盘可操作的对话框
下面的完整页面只使用原生按钮和 <dialog>。按钮天然支持 Enter 与 Space,模态对话框负责隔离背景区域,JavaScript 只管理初始焦点和关闭后的恢复位置。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>焦点管理示例</title>
</head>
<body>
<button id="openDialog" type="button">编辑个人资料</button>
<dialog id="profileDialog" aria-labelledby="dialogTitle">
<form method="dialog">
<h2 id="dialogTitle">编辑个人资料</h2>
<label>
昵称
<input name="nickname" autocomplete="nickname">
</label>
<button value="save">保存</button>
<button id="closeDialog" value="cancel">取消</button>
</form>
</dialog>
<script>
const openButton = document.querySelector('#openDialog');
const dialog = document.querySelector('#profileDialog');
const closeButton = document.querySelector('#closeDialog');
let focusBeforeOpen = null;
openButton.addEventListener('click', () => {
// 记录真实触发位置,避免关闭后把焦点送到页面顶部。
focusBeforeOpen = document.activeElement;
dialog.showModal();
closeButton.focus();
});
dialog.addEventListener('close', () => {
// 元素仍在文档中时才恢复,兼容触发按钮被动态删除的情况。
if (focusBeforeOpen?.isConnected) {
focusBeforeOpen.focus();
}
});
</script>
</body>
</html>预期结果
使用 Tab 聚焦“编辑个人资料”按钮后,按 Enter 或 Space 可打开对话框。
对话框打开时焦点位于“取消”按钮,Tab 和 Shift+Tab 在弹层控件间移动。
按 Escape、保存或取消关闭对话框后,焦点返回“编辑个人资料”按钮。可以在浏览器开发者工具控制台中查看 document.activeElement,验证每个阶段的当前焦点。鼠标点击只是补充路径,所有核心操作都应能通过键盘独立完成。
常见焦点管理错误
关闭弹层后直接调用 document.body.focus() 通常没有意义,也会让键盘用户失去原来的操作位置。另一个常见问题是在不可见元素上保留焦点,例如先隐藏弹层,再尝试读取其中的活动控件。
对于菜单、标签页和工具栏等复合组件,不应让所有子项同时进入 Tab 顺序。通常只保留一个 tabindex="0" 的活动项,其余项目设为 -1,再使用方向键移动焦点,这种方式称为移动式 tabindex。