Элемент: свойство ariaSort

Базовая версия 2023

Новое

С октября 2023 года эта функция работает на последних версиях устройств и браузеров. Возможно, эта функция не будет работать на старых устройствах или браузерах.

Свойство ariaSort интерфейса Element отражает значение атрибута aria-sort, который указывает, отсортированы ли элементы в таблице или сетке по возрастанию или убыванию.

Значение

Строка с одним из следующих значений:

"ascending": Элементы отсортированы по возрастанию по этому столбцу.
"descending": Элементы отсортированы по убыванию по этому столбцу.
"none": Для столбца не определена сортировка.
"other": Применён алгоритм сортировки, отличный от возрастания или убывания.

Примеры

В этом примере атрибут aria-sort элемента с идентификатором role-heading имеет значение "none". Используя ariaSort, мы обновляем значение на "ascending".

<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

Совместимость с браузерами

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`ariaSort`	81	81	119	68	12.1	81	119	58	12.2	13.0	81

См. также

ARIA: роль таблицы

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaSort