HTMLMediaElement: addTextTrack() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

addTextTrack() 方法是 HTMLMediaElement 接口的一个方法,用于创建一个新的 TextTrack 对象并将其添加到媒体元素中。它会在该媒体元素的 textTracks 上触发一个 addtrack 事件。此方法不能在 TextTrackList 接口上使用,只能在 HTMLMediaElement 上使用。

语法

js
addTextTrack(kind)
addTextTrack(kind, label)
addTextTrack(kind, label, language)

参数

kind

一个字符串,表示 TextTrack.kind 属性(subtitlescaptionsdescriptionschaptersmetadata)。

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

浏览器兼容性

另见