Element:ariaLive 属性
Element
接口的 ariaLive
属性反映了 aria-live
(en-US) 属性的值,该属性表示一个元素将被更新,并描述了用户代理、辅助技术和用户可以从实时区域中期望的更新类型。
值
一个具有以下值之一的字符串:
"assertive"
-
表示对该区域的更新具有最高优先级,并应立即呈现给用户。
"off"
-
表示除非用户当前聚焦于该区域,否则不应向用户呈现对该区域的更新。
"polite"
-
表示应在下一个适当的机会(例如,在说完当前句子或用户暂停输入时)呈现对该区域的更新。
示例
在此示例中,ID 为 planetInfo
的元素上的 aria-live
(en-US) 属性设置为 "polite"
。然后我们将值更新为 "assertive"
。
html
<div role="region" id="planetInfo" aria-live="polite">
<h2 id="planetTitle">未选择星球</h2>
<p id="planetDescription">选择一个星球以查看其描述</p>
</div>
js
let el = document.getElementById("planetInfo");
console.log(el.ariaLive); // "polite"
el.ariaLive = "assertive";
console.log(el.ariaLive); // "assertive"
规范
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # dom-ariamixin-arialive |
浏览器兼容性
BCD tables only load in the browser