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

瀏覽器相容性