界面组件 深入了解 B · 官方指南或术语 平台: 网页

Roving tabindex

单一 Tab 停靠点

Roving tabindex 让一组控件只占一个 Tab 停靠点。进入后,方向键会在同组项目之间移动焦点。

看看怎样运作
也有人这样说 Roving tabindex单一 Tab 停靠点方向键焦点移动roving tab index

看看怎样运作

原创情境示例单一 Tab 停靠点
无障碍界面规则单一 Tab 停靠点one tabindex=0 + remaining tabindex=-1 + arrow key swaps the active item
文本工具栏1 Tab stop
粗体tabindex=0斜体-1链接-1引用-1
向右键粗体 0 → 斜体 0focus() + swap tabindex
Tab → 进入一次Tab → 离开一次
通过工具栏只占一个 Tab 停靠点,内部改用方向键。避免不要让两个项目同时使用 tabindex 0。
one tabindex=0 + remaining tabindex=-1 + arrow key swaps the active itemA11Y
单一 Tab 停靠点无障碍界面实践

另一个例子

工具栏一开始只有“粗体”使用 tabindex 0,其他按钮使用 -1。按向右键后,0 会移到“斜体”。

主要部分

  1. 01复合组件
  2. 02单一 Tab 停靠点
  3. 03未激活项目
  4. 04方向键规则
  5. 05更新后的当前项目
  6. 06Tab 离开位置

什么时候用

复合组件有明确的方向键操作规则时,可以使用这个方法。普通 Tab 顺序中只能保留一个项目。

什么时候不要用

不要用在互不相关的链接或整个页面。也不要让两个项目同时使用 tabindex 0。

代码里的名称

one tabindex=0 + remaining tabindex=-1 + arrow key swaps the active item

上线前要检查

让辅助工具知道控件的名称(无障碍名称)、用途(角色)、值与状态。检查键盘操作、清楚可见的焦点、点击范围、禁用与忙碌状态、反馈及恢复。

可以直接复制的需求

预期结果:使用 单一 Tab 停靠点 (Roving tabindex) 解决这项需求,同时保留用户当前的操作上下文。 用户场景:工具栏一开始只有“粗体”使用 tabindex 0,其他按钮使用 -1。按向右键后,0 会移到“斜体”。 建议界面模式:单一 Tab 停靠点 (Roving tabindex)。 适用理由:复合组件有明确的方向键操作规则时,可以使用这个方法。普通 Tab 顺序中只能保留一个项目。 不应使用的情况:不要用在互不相关的链接或整个页面。也不要让两个项目同时使用 tabindex 0。 产品要求:定义默认、加载、没有内容、错误、成功与恢复状态。保留用户已输入的内容,每个操作后都提供清楚反馈。 无障碍与韧性:使用结构正确的 HTML(语义化 HTML)和完整键盘操作。焦点要清楚可见,布局缩放后仍要好用。也要提供减少动态效果。遵守项目现有规则。除非项目已采用,否则不要新增界面组件库。 验收标准:主要任务可只用键盘完成,在 320px 宽度也能正常使用。焦点与状态变化可被辅助工具读出。加载、失败、重试、取消与减少动态效果都已验证。 证据与限制(证据边界):它只代表该来源的官方说法。其他平台或团队可能有不同用法。 待确认:产品文字、数据来源、分析事件、支持设备与语言,以及平台特有限制。

检查这份需求

请 AI 编程助手检查当前如何使用 单一 Tab 停靠点 (Roving tabindex)。 定义:Roving tabindex 让一组控件只占一个 Tab 停靠点。进入后,方向键会在同组项目之间移动焦点。 生产环境检查:让辅助工具知道控件的名称(无障碍名称)、用途(角色)、值与状态。检查键盘操作、清楚可见的焦点、点击范围、禁用与忙碌状态、反馈及恢复。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。

B
这个术语有多正式?

官方指南或术语

列出的平台、框架、项目或专业组织,发布了这个术语的官方指南。

它只代表该来源的官方说法。其他平台或团队可能有不同用法。

适用范围
只包含来源有说明的内容:正式名称、定义、交互行为、键盘行为、无障碍
文档状态
稳定
核验日期
2026-07-30

证据来源与适用范围

正式来源 + 术语参考资料 · W3C WAI · 稳定 Managing Focus Within Components Using a Roving tabindex 适用范围: 正式名称、定义、交互行为、键盘行为、无障碍 本页用途: 直接术语参考 来源涵盖内容: 正式名称, 定义, 交互行为, 键盘行为, 无障碍 背景资料 WAI-ARIA 1.2 — aria-activedescendant 本页用途: 提供背景,不是正式定义

自行复制

浏览器无法自动复制。请选择下方文字,再自行复制。