TextTrackList: length 属性

Baseline 已广泛支持

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

只读的 TextTrackList 属性 length 返回 TextTrackList 中的条目数量,每个条目都是一个 TextTrack 对象,代表媒体元素中的一个轨道。

值为 0 表示媒体中没有文本轨道。

一个数字,指示 TextTrackList 中包含多少个文本轨道。可以通过将 TextTrackList 视为一个对象数组(类型为 TextTrack)来访问每个轨道。

示例

此代码片段通过 querySelector() 获取在 DOM 中找到的第一个媒体元素的文本轨道数量。

js
const mediaElem = document.querySelector("video, audio");
let numTextTracks = 0;

if (mediaElem.textTracks) {
  numTextTracks = mediaElem.textTracks.length;
}

请注意,此示例会检查以确保 HTMLMediaElement.textTracks 已定义,以避免在不支持 TextTrack 的浏览器上出错。

规范

规范
HTML
# dom-texttracklist-length

浏览器兼容性