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

另見