SpeechSynthesisUtterance: mark 事件

基线 广泛可用

此功能已经很成熟,可以在许多设备和浏览器版本上运行。自 2018 年 9 月.

mark 事件属于 Web 语音 API SpeechSynthesisUtterance 对象,当 spoken utterance 达到命名的 SSML "mark" 标签时触发。

语法

在像 addEventListener() 这样的方法中使用事件名称,或者设置事件处理程序属性。

js
addEventListener("mark", (event) => {});

onmark = (event) => {};

事件类型

事件属性

除了下面列出的属性外,父接口 Event 的属性也可使用。

charIndex 只读

返回事件触发时正在朗读的 SpeechSynthesisUtterance.text 中字符的索引位置。

elapsedTime 只读

返回事件触发时,SpeechSynthesisUtterance.text 开始朗读后的经过时间(以秒为单位)。

name 只读

返回与 SpeechSynthesisUtterance.text 朗读过程中发生的某些类型的事件相关的名称:在 mark 事件情况下,返回所到达的 SSML 标记的名称,在 boundary 事件情况下,返回所到达的边界类型。

utterance 只读

返回触发事件的 SpeechSynthesisUtterance 实例。

示例

您可以在 addEventListener 方法中使用 mark 事件

js
utterThis.addEventListener("mark", (event) => {
  console.log(`A mark was reached: ${event.name}`);
});

或使用 onmark 事件处理程序属性

js
utterThis.onmark = (event) => {
  console.log(`A mark was reached: ${event.name}`);
};

规范

规范
Web 语音 API
# eventdef-speechsynthesisutterance-mark
Web 语音 API
# dom-speechsynthesisutterance-onmark

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅