Элемент: свойство ariaRelevant
Базовая версия 2023
Новое свойство
Начиная с октября 2023 года, эта функция работает на последних устройствах и версиях браузеров. Возможно, эта функция не будет работать на более старых устройствах или браузерах.
Нестандартный: Эта функция нестандартна и не находится на стадии стандартизации. Не используйте ее на сайтах, ориентированных на Веб: она не будет работать для всех пользователей. Также могут быть значительные несовместимости между реализациями, и поведение может измениться в будущем.
Свойство ariaRelevant интерфейса Element отражает значение атрибута aria-relevant, который указывает, какие уведомления пользовательский агент будет генерировать при изменении дерева доступности внутри активной области. Это используется для описания, какие изменения в aria-live области являются релевантными и должны быть объявлены.
Значение
Строка, содержащая одно или несколько из следующих значений, разделенных пробелами:
"additions"-
Добавление узлов элемента в активной области должно считаться релевантным.
"removals"-
Удаление узлов из активной области должно считаться релевантным.
"text"-
Изменения текстового содержимого существующих узлов должны считаться релевантными.
"all"-
Эквивалентно
"additions removals text".
Примеры
В этом примере атрибут aria-relevant для элемента с идентификатором text установлен в «all». Используя ariaRelevant, мы обновляем значение на «text».
<div id="clock" role="timer" aria-live="polite" aria-atomic="true" aria-relevant="all"></div>
let el = document.getElementById("clock");
console.log(el.ariaRelevant); // all
el.ariaRelevant = "text";
console.log(el.ariaRelevant); // text
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
ariaRelevant |
81 | 81 | 119 | 68 | 12.1 | 81 | 119 | 58 | 12.2 | 13.0 | 81 |
© 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/ariaRelevant