Element: ariaSort-Eigenschaft

Baseline 2023

Newly available

Since October 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Die ariaSort-Eigenschaft der Element-Schnittstelle spiegelt den Wert des aria-sort-Attributs wider, welches angibt, ob die Elemente in einer Tabelle oder einem Gitter in aufsteigender oder absteigender Reihenfolge sortiert sind.

Wert

Ein String mit einem der folgenden Werte:

"ascending": Elemente sind nach dieser Spalte in aufsteigender Reihenfolge sortiert.
"descending": Elemente sind nach dieser Spalte in absteigender Reihenfolge sortiert.
"none": Es ist keine definierte Sortierung auf die Spalte angewendet.
"other": Ein anderes Sortierverfahren als aufsteigend oder absteigend wurde angewendet.

Beispiele

In diesem Beispiel wird das aria-sort-Attribut auf dem Element mit der ID role-heading auf "none" gesetzt. Mithilfe von ariaSort aktualisieren wir den Wert auf "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

Spezifikationen

Specification
Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-ariasort

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

ARIA: Tischrolle