元素：ariaSort 属性

基线 2023

新可用

自 2023 年 10 月起，此功能可在最新的设备和浏览器版本上运行。此功能可能无法在较旧的设备或浏览器上运行。

元素接口的**ariaSort**属性反映了Element aria-sort属性的值，该属性指示表格或网格中的项目是按升序还是降序排序。

值

一个具有以下值之一的字符串

"ascending": 项目按此列升序排序。
"descending": 项目按此列降序排序。
"none": 此列没有应用已定义的排序。
"other": 已应用除升序或降序之外的其他排序算法。

示例

在此示例中，ID 为role-heading的元素上的aria-sort属性设置为“none”。使用ariaSort，我们将值更新为“ascending”。

html

<table
  id="semantic-table"
  role="table"
  aria-label="Semantic Elements"
  aria-describedby="semantic_elements_table_desc"
  aria-rowcount="100">
  <caption id="semantic_elements_table_desc">
    Semantic Elements to use instead of ARIA's roles
  </caption>
  <thead role="rowgroup">
    <tr role="row">
      <th
        role="columnheader"
        id="role-heading"
        aria-sort="none"
        aria-rowindex="1"
        aria-colindex="1">
        ARIA Role
      </th>
      <th
        role="columnheader"
        id="element-heading"
        aria-sort="none"
        aria-rowindex="1">
        Semantic Element
      </th>
    </tr>
  </thead>
  <tbody role="rowgroup">
    <tr role="row">
      <td role="cell" aria-rowindex="11">header</td>
      <td role="cell" aria-rowindex="11">h1</td>
    </tr>
    <tr role="row">
      <td role="cell" aria-rowindex="16">header</td>
      <td role="cell" aria-rowindex="16">h6</td>
    </tr>
    <tr role="row">
      <td role="cell" aria-rowindex="18">rowgroup</td>
      <td role="cell" aria-rowindex="18">thead</td>
    </tr>
    <tr role="row">
      <td role="cell" aria-rowindex="24">term</td>
      <td role="cell" aria-rowindex="24">dt</td>
    </tr>
  </tbody>
</table>

let el = document.getElementById("role-heading");
console.log(el.ariaSort); // none
el.ariaSort = "ascending";
console.log(el.ariaSort); // ascending

规范

规范
可访问的富互联网应用 (WAI-ARIA) # dom-ariamixin-ariasort

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅

ARIA：表格角色