tabindex 是控制元素键盘聚焦能力及顺序的属性;设为 1 会打乱 DOM 顺序导致可访问性问题,应优先用 0 或省略;含可聚焦子元素的父容器无需额外设置;禁用聚焦应通过 CSS/HTML 实现而非 tabindex="-1"。

tabindex 是什么,为什么不能只设成 1
它不是“翻页开关”,而是告诉浏览器这个元素能不能被键盘聚焦、以什么顺序聚焦。tabindex 值为 0 表示按 DOM 顺序自然加入 Tab 流;正数(如 1、2)会强行插队,打乱默认逻辑,容易让屏幕阅读器用户迷失。
常见错误现象:tabindex="1" 写了一堆按钮,结果按 Tab 键跳转顺序和页面视觉流完全不一致,甚至跳到页脚再跳回头部。
- 所有需要键盘翻页的容器(比如图片画廊、文章分页栏)应统一用
tabindex="0" - 如果容器内已有可聚焦子元素(如
<button></button>、<a href></a>),父容器不需要额外加tabindex,否则会重复聚焦 - 绝对不要用
tabindex="-1"来“禁用”翻页——它只是让元素不可通过 Tab 进入,但 JS 仍可通过.focus()聚焦,反而造成行为不一致
监听键盘事件时,keydown 还是 keyup?该过滤哪些键
用 keydown,因为它是按键按下即触发,响应更快;keyup 有延迟,连续按方向键时容易漏掉一次翻页。
必须过滤掉组合键和非意图操作:比如用户按 Ctrl+Tab 切换浏览器标签,或 Alt+D 聚焦地址栏,这些都不该触发你的翻页逻辑。
立即学习“前端免费学习笔记(深入)”;
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 检查
event.ctrlKey、event.altKey、event.metaKey是否为true,是则直接return - 只响应
ArrowLeft/ArrowRight(左右翻页)、PageUp/PageDown(整屏翻页),避免监听Enter或Space—— 它们语义属于“确认”或“展开”,不是导航 - 移动端没有物理方向键,所以纯键盘翻页逻辑默认不生效;别试图用
touchstart模拟,那不属于“键盘翻页”范畴
focus() 后滚动不到可视区?scrollIntoView 的坑
调用 element.focus() 不会自动滚动,尤其当元素在折叠区域、overflow: hidden 容器里,或被 sticky 导航栏遮挡时,焦点进了但看不见。
scrollIntoView() 看似能解,但它默认行为在不同浏览器差异大:Chrome 可能滚顶部,Safari 滚中间,Firefox 滚底部;而且它会触发全局滚动,打断用户正在做的操作。
- 优先用
element.scrollIntoView({ block: 'nearest', inline: 'nearest' }),避免强制对齐顶部/底部 - 加个节流判断:只有当元素
getBoundingClientRect().top小于 0 或大于window.innerHeight时才滚动 - 如果父容器设置了
overflow: auto,得对那个容器调用scrollIntoView(),而不是目标元素本身——否则滚动的是整个页面,不是局部区域
键盘翻页和 ARIA 属性怎么配合才不算画蛇添足
加了 aria-live 或 aria-label 不代表可访问性就达标;乱加反而干扰屏幕阅读器。核心原则是:只声明“变化”,不重复“结构”。
常见错误现象:给每张图片都加 aria-label="第3页,标题是xxx",结果朗读两次“第3页”,一次来自 aria-label,一次来自实际文本内容。
- 翻页动作发生后,用
aria-live="polite"的<div> 动态更新当前页码,比如 “已切换到第5页,共12页” <li>翻页按钮本身用 <code>aria-current="true"标记当前激活项(仅限按钮组场景),不要用在内容区 - 禁止给翻页容器加
role="application"—— 它会关闭屏幕阅读器的标准导航模式,把键盘翻页变成“应用专属操作”,普通用户根本不知道怎么用
最常被忽略的一点:键盘翻页必须和鼠标点击行为完全同步——不只是视觉反馈一致,还要确保同一套数据状态、URL 参数(如 ?page=3)、历史记录(history.pushState)全部对齐。否则用户按完右箭头,再点浏览器后退,页面状态就错乱了。


















