ARIA: aria-sort 属性
aria-sort 属性用于指示表格或网格中的项目是按升序还是降序排序的。
描述
如果网格或表格提供了排序功能,则应将 aria-sort 属性设置为 ascending 或 descending(或 other),并应用于已排序列或行的标题单元格元素。
aria-sort 属性仅应用于当前排序的列或行。设置为 aria-sort="ascending" 以指示该列或行中的数据单元格按升序排序。如果排序顺序相反,则将该值切换为 aria-sort="descending"。当另一列或行变为已排序时,唯一的 aria-sort 属性将移动到新排序的列或行的标题单元格,并带有适用于排序顺序的值。
aria-sort 属性一次只应添加到单个表格或网格标题中。设置此属性是为了告知辅助技术用户当前哪个列或行已排序。它不会影响实际的排序顺序。
示例
此表格在姓氏列按升序排序的情况下加载。
<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 |
另见
- 可排序表格示例 - ARIA Authoring Practices Guide (APG)
aria-pressed<th>元素