HTMLMediaElement: addTextTrack() 方法
addTextTrack() 方法是 HTMLMediaElement 接口的一个方法,用于创建一个新的 TextTrack 对象并将其添加到媒体元素中。它会在该媒体元素的 textTracks 上触发一个 addtrack 事件。此方法不能在 TextTrackList 接口上使用,只能在 HTMLMediaElement 上使用。
语法
js
addTextTrack(kind)
addTextTrack(kind, label)
addTextTrack(kind, label, language)
参数
kind-
一个字符串,表示
TextTrack.kind属性(subtitles、captions、descriptions、chapters或metadata)。 label-
一个字符串,表示
TextTrack.label属性。 language-
一个字符串,表示
TextTrack.language属性。
返回值
新创建的 TextTrack 对象。
异常
无。
示例
此示例添加了一个 kind 设置为 "subtitles" 的新 TextTrack,并向其添加了一个新的 VTTCue。
js
const video = document.querySelector("video");
const newTrack = video.addTextTrack("subtitles");
newTrack.addCue(new VTTCue(3, 6, "Hello world!"));
console.log(newTrack.cues[0].text);
// "Hello world!"
规范
| 规范 |
|---|
| HTML # dom-media-addtexttrack-dev |
浏览器兼容性
加载中…