このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

ARIA: aria-sort 属性

aria-sort 属性は、表またはグリッド内のアイテムが昇順または降順のどちらで並べ替えられているかを示します。

解説

表またはグリッドが並べ替え機能を提供する場合、並べ替えられた列または行の見出しセル要素の aria-sort 属性に ascending または descending(または other)を設定する必要があります。

aria-sort 属性は、現在並び替えられている列または行にのみ設定されます。列または行のデータセルが昇順でソートされていることを示すためには aria-sort="ascending" を設定してください。並び替え順序が逆になっている場合は、値を aria-sort="descending" に切り替えてください。別の列または行が並び替えられると、単一の aria-sort 属性が、適切な並び替え順序を示す値で、新しく並び替えられた列または行の見出しセルに移動されます。

aria-sort 属性は、一度に表またはグリッドの 1 つの見出しにのみ追加する必要があります。この属性は支援技術のユーザーに、どの列または行が並べ替えられているかを通知するために設定されます。実際の並べ替え順序には影響しません。

値

ascending

アイテムはこの列の昇順で並べ替えられます。

descending

アイテムはこの列の降順で並べ替えられます。

none (デフォルト)

列には並べ替え順序が定義されていません。

other

昇順または降順以外の並び替えアルゴリズムが適用されました。

関連インターフェイス

Element.ariaSort

Element インターフェイスの一部である ariaSort プロパティは、aria-sort 属性の値を反映します。

ElementInternals.ariaSort

ElementInternals インターフェイスの一部である ariaSort プロパティは、aria-sort 属性の値を反映します。

関連付けられたロール

使用するロール:

例

この表は、姓の列が昇順で並べ替えられた状態で読み込まれます。

html
<table>
  <caption>
    運営委員会のメンバー
  </caption>
  <thead>
    <tr>
      <th>
        <button>名</button>
      </th>
      <th aria-sort="ascending">
        <button>姓</button>
      </th>
      <th>
        <button>所属企業</button>
      </th>
      <th>メールアドレス</th>
    </tr>
  </thead>
  <tbody>
    …
  </tbody>
</table>

ユーザーが姓ボタンをクリックすると、aria-pressed="true" が <button> 要素に追加され、JavaScript によって aria-sort の値が "descending" に切り替わります。ユーザーが別の見出しボタンをクリックすると、aria-sort が姓の見出しから削除され、クリックしたボタンの親要素である <th> に設定されます。

CSS で th[aria-sort="ascending"] および th[aria-sort="descending"] セレクターを対象に追加する下向き矢印が見えない支援技術の利用者に向けて、キャプションに説明を記載しています。

仕様書

仕様書
Accessible Rich Internet Applications (WAI-ARIA)
# aria-sort

関連情報