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

ARIA:columnheader 角色

· 52CE 我爱测

ARIA role 属性的 `columnheader` 值将元素标识为行中的一个单元格,该单元格包含某一列的表头信息,类似于带有列作用域的原生 th 元素。

ARIA role 属性的 columnheader 值将元素标识为行中的一个单元格,该单元格包含某一列的表头信息,类似于带有列作用域的原生 th 元素。

描述

具有 role="columnheader" 且作为 role="row" 元素的后代嵌套的元素,是表格容器(可以是 table 或 grid,也可以是需要展示数据关系的其他图表)中列标题单元格的静态表格结构。要获得支持,columnheader 必须嵌套在具有 row 角色的元素中。

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

所有列标题都应嵌套在 row 中。而每一行又应嵌套在 grid、table 或 treegrid 中,或者嵌套在上述容器之一的 rowgroup 中。

  • aria-sort
    • : aria-sort 属性一次只应用于一个列标题(如果有的话),它通过三个取值来指示某一列的排序情况:ascending(升序)、descending(降序)或 none(未排序)。

键盘交互

该角色不支持任何特定的键盘交互。

所需的 JavaScript 特性

只有在使用了 aria-sort 属性时才需要 JavaScript。

示例

<table>
  <thead>
    <tr role="row">
      <th role="columnheader" scope="col">
        <button>名字</button>
      </th>
      <th role="columnheader" scope="col">
        <button>姓氏</button>
      </th>
      <th role="columnheader" scope="col" aria-sort="ascending">
        <button>公司名称</button>
      </th>
      <th role="columnheader" scope="col">
        <button>职位</button>
      </th>
    </tr>
  </thead>
  <tbody>
    …
  </tbody>
</table>

最佳实践

列标题应当包含该列的标题或表头信息。

ARIA 的第一规则是:如果原生 HTML 元素或属性已经具备你所需要的语义和行为,就使用它,而不是重新利用某个元素并添加 ARIA 角色、状态或属性来使其可访问。建议使用原生 HTML <th> 元素并将 scope 属性设置为 <th scope="col">,而不是使用 <div> 或其他元素。如果使用语义化 HTML 的 <th scope="col">,则 role 属性不是必需的,但仍可以将其包含在内作为后备,以确保在默认语义因某个 CSS display 属性值而被移除时,表格仍能保留其语义。

即使未指定 ARIA role 属性,也可以将 aria-sort 属性添加到 <th scope="col"> 上。

优先使用 HTML

columnheader 与 <th scope="col"> 具有相同的语义。

规范

参见

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

资料来源与适用范围

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

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

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