大网数据广告活动
Web 标准与前端开发

ARIA:list 角色

· 52CE 我爱测

ARIA `list` 角色可用于标识项目列表。它通常与 `listitem` 角色结合使用,该角色用于标识包含在列表中的列表项。

ARIA list 角色可用于标识项目列表。它通常与 listitem 角色结合使用,该角色用于标识包含在列表中的列表项。

<section role="list">
  <div role="listitem">列表项 1</div>
  <div role="listitem">列表项 2</div>
  <div role="listitem">列表项 3</div>
</section>

描述

任何由外部容器和内部元素列表组成的内容都可以分别使用 list 和 listitem 容器识别为辅助技术。一个 list 必须有一个或多个 listitem 子级,或者,有一个或多个 group 作为子级,每个 group有一个或多个 listitem 作为子项。

关于应该使用哪些元素来标记 list 和 listitem 没有硬性规定,但是你应该确保 listitem 在列表的上下文中有意义,例如购物清单、食谱步骤、行车路线。

[!NOTE] 最佳实践要求使用适当的语义 HTML 元素来标记列表和列表项,如 ul、ol 和 li。有关完整示例,请参阅最佳实践。

关联的 WAI-ARIA 角色、状态和属性

  • listitem 角色
    • : 列表或目录中的单个项目。角色为 listitem 的元素只能在角色为 list 或 group 的元素中找到。
  • group 角色
    • : 相关对象的集合,在嵌套在列表中时仅限于列表项,其重要性不足以在页面目录中拥有自己的位置。

最佳实践

仅在必要时使用 role="list" 和 role="listitem"。例如,无法控制 HTML 但能够在之后动态使用 JavaScript 提升无障碍的时候。

与 HTML ol 和 ul 不同,ARIA list 角色不区分有序列表和无序列表。如果可能,你应该使用适当的语义 HTML 元素来标记列表(ol 和 ul)和列表项(li)。例如,我们上面的例子应该改写如下:

<ul>
  <li>列表项 1</li>
  <li>列表项 2</li>
  <li>列表项 3</li>
</ul>

或者如果列表项的顺序很重要,则使用有序列表:

<ol>
  <li>列表项 1</li>
  <li>列表项 2</li>
  <li>列表项 3</li>
</ol>

[!NOTE] ARIA list / listitem 角色不区分有序列表和无序列表。

顺便说一句,请注意,如果你使用 <ol> 或 <ul> 的语义 HTML 元素并应用 presentation 角色,则每个子 <li> 元素都会继承 presentation 角色,因为 ARIA 需要 listitem 元素具有父 list 元素。因此,<li> 元素不会暴露给辅助技术,但是包含在这些 <li> 元素中的元素,包括嵌套列表,对辅助技术是可见的。

[!NOTE] 如果要标记将用作标签页式界面的项目列表,则应改为使用 tab、tabpanel 和 tablist 角色。

规范

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。