Элемент: свойство ariaLive
Базовая версия 2023
Новое свойство
С октября 2023 года эта функция работает на последних версиях устройств и браузеров. Возможно, эта функция не будет работать на старых устройствах или браузерах.
Свойство ariaLive интерфейса Element отражает значение атрибута aria-live, который указывает, что элемент будет обновлён, и описывает типы обновлений, которые могут ожидать пользовательские агенты, вспомогательные технологии и пользователь от живой области.
Значение
Строка с одним из следующих значений:
"assertive"-
Указывает, что обновления области имеют наивысший приоритет и должны быть представлены пользователю немедленно.
"off"-
Указывает, что обновления области не должны быть представлены пользователю, если пользователь в данный момент не сосредоточен на этой области.
"polite"-
Указывает, что обновления области должны быть представлены в удобный момент, например, в конце произнесения предложения или когда пользователь прерывает ввод текста.
Примеры
В этом примере атрибут aria-live элемента с идентификатором planetInfo установлен в значение "polite". Затем мы обновляем значение до "assertive".
<div role="region" id="planetInfo" aria-live="polite"> <h2 id="planetTitle">No planet selected</h2> <p id="planetDescription">Select a planet to view its description</p> </div>
let el = document.getElementById("planetInfo");
console.log(el.ariaLive); // "polite"
el.ariaLive = "assertive";
console.log(el.ariaLive); // "assertive"
Спецификации
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
ariaLive |
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/ariaLive