SpeechSynthesisUtterance: mark イベント
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2018年9月.
mark はウェブ音声 API の SpeechSynthesisUtterance オブジェクトのイベントで、発話が SSML の名前付き "mark" タグに達したときに発生します。
構文
このイベント名を addEventListener() などのメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。
addEventListener("mark", (event) => {});
onmark = (event) => {};
イベント型
SpeechSynthesisEvent です。 Event を継承しています。
イベントプロパティ
以下に挙げたプロパティに加え、親インターフェイスである Event のプロパティが利用可能です。
charIndex読取専用-
イベントが発生したときに発話されていた
SpeechSynthesisUtterance.text内の文字のインデックス位置を返します。 elapsedTime読取専用-
イベントが発生した時点の
SpeechSynthesisUtterance.textが話し始めてからの経過時間(秒)を返します。 name読取専用-
SpeechSynthesisUtterance.textが発話される際に発生する特定の種類のイベントに関連する名前を返します。markイベントの場合は到達した SSML マーカーの名前、boundaryイベントの場合は到達した境界の種類です。 utterance読取専用-
イベントが発生した
SpeechSynthesisUtteranceインスタンスを返します。
例
mark イベントを addEventListener メソッドで使用することができます。
utterThis.addEventListener("mark", (event) => {
console.log(`A mark was reached: ${event.name}`);
});
または onmark イベントハンドラープロパティで使用することができます。
utterThis.onmark = (event) => {
console.log(`A mark was reached: ${event.name}`);
};
仕様書
| Specification |
|---|
| Web Speech API> # eventdef-speechsynthesisutterance-mark> |
| Web Speech API> # dom-speechsynthesisutterance-onmark> |
ブラウザーの互換性
Loading…