TextTrackCueList：getCueById() 方法

基线 广泛可用

此功能已得到良好确立，并且可在许多设备和浏览器版本上运行。它自以下时间起在浏览器中可用： 2015 年 7 月.

getCueById() 方法是 TextTrackCueList 接口的一部分，它返回列表中第一个与 id 值匹配的 VTTCue。该列表由 TextTrackCueList 对象表示。

语法

js
getCueById(id)

参数

id

表示提示符的标识符字符串。

返回值

一个 VTTCue 对象。

示例

TextTrack.cues 属性返回一个 TextTrackCueList，其中包含该特定音轨的当前提示符。调用 cues.getCueById("second") 将返回 ID 为“second”的 VTTCue。

WEBVTT

first
00:00:00.000 --> 00:00:00.999 line:80%
Hildy!

second
00:00:01.000 --> 00:00:01.499 line:80%
How are you?
js
const video = document.getElementById("video");
video.onplay = () => {
  console.log(video.textTracks[0].cues.getCueById("second")); // a VTTCue object;
};

规范

规范
HTML 标准
# dom-texttrackcuelist-getcuebyid

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。