页面级 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 向屏幕阅读器播报消息,同时不会转移焦点。

AriaAnnouncer

方法

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。