ARIA: aria-sort 属性

aria-sort 属性用于指示表格或网格中的项目是按升序还是降序排序的。

描述

如果网格或表格提供了排序功能,则应将 aria-sort 属性设置为 ascendingdescending(或 other),并应用于已排序列或行的标题单元格元素。

aria-sort 属性仅应用于当前排序的列或行。设置为 aria-sort="ascending" 以指示该列或行中的数据单元格按升序排序。如果排序顺序相反,则将该值切换为 aria-sort="descending"。当另一列或行变为已排序时,唯一的 aria-sort 属性将移动到新排序的列或行的标题单元格,并带有适用于排序顺序的值。

aria-sort 属性一次只应添加到单个表格或网格标题中。设置此属性是为了告知辅助技术用户当前哪个列或行已排序。它不会影响实际的排序顺序。

示例

此表格在姓氏列按升序排序的情况下加载。

html
<table>
  <caption>
    Steering Committee Members
  </caption>
  <thead>
    <tr>
      <th>
        <button>First Name</button>
      </th>
      <th aria-sort="ascending">
        <button>Last Name</button>
      </th>
      <th>
        <button>Company</button>
      </th>
      <th>Email</th>
    </tr>
  </thead>
  <tbody>
    …
  </tbody>
</table>

如果用户单击“姓氏”按钮,则会向 <button> 元素添加 aria-pressed="true",并且 aria-sort 的值将通过 JavaScript 切换为 "descending"。如果用户单击其他标题按钮,则会从“姓氏”标题中移除 aria-sort,并将其放置在被单击按钮的 <th> 父元素上。

我们在标题中提供了说明,以供可能看不到我们通过 CSS 定向 th[aria-sort="ascending"]th[aria-sort="descending"] 选择器添加的向下箭头的辅助技术使用。

ascending

此列按升序排序。

descending

此列按降序排序。

none(默认)

该列未应用已定义的排序。

其他

已应用非升序或降序的排序算法。

相关接口

Element.ariaSort

Element 接口的一部分 ariaSort 属性反映了 aria-sort 属性的值。

ElementInternals.ariaSort

ElementInternals 接口的一部分 ariaSort 属性反映了 aria-sort 属性的值。

相关角色

用于角色

规范

规范
无障碍富互联网应用程序 (WAI-ARIA)
# aria-sort

另见