页面级 aria-live 播报器,用于向屏幕阅读器发送消息,同时不会转移焦点。消息作为子 div 被追加到两个持久 live region 中的一个:polite 或 assertive(两者均为 aria-atomic="false"、aria-relevant="additions"),因此每个子元素在添加时都会被独立播报。较早的消息会保留在 DOM 中,且不会被重新读取。每条消息会在足够长的时间延迟后被移除,以确保屏幕阅读器已捕获该变更,从而在长时间会话中保持 region 的范围可控。polite 和 assertive 区域的唯一区别在于其 aria-live 礼貌级别:assertive 播报会打断屏幕阅读器当前的朗读,而 polite 播报则会等待当前朗读结束后再执行。
摘要
方法
| 名称 | 摘要 | 定义者 |
|---|---|---|
announce() | 通过 aria-live region 向屏幕阅读器播报消息,同时不会转移焦点。 |
|
方法
announce()
announce(message: String, options: Object, options.assertive: Boolean)
通过 aria-live region 向屏幕阅读器播报消息,同时不会转移焦点。
示例
tinymce.dom.AriaAnnouncer.announce('Bold on');
tinymce.dom.AriaAnnouncer.announce('Error occurred', { assertive: true });参数
message (String)- 要向屏幕阅读器播报的消息。options (Object)- 可选设置。options.assertive (Boolean)- 如果为 true,则使用 aria-live="assertive" 而非 polite。