HTMLTrackElement

例項屬性

繼承自其父級 HTMLElement 的屬性。

HTMLTrackElement.kind

一個字串，反映了 kind HTML 屬性，指示文字軌道的用途。可能的值包括：subtitles、captions、descriptions、chapters 或 metadata。

HTMLTrackElement.src

一個字串，反映了 src HTML 屬性，指示文字軌道資料的地址。

HTMLTrackElement.srclang

一個字串，反映了 srclang HTML 屬性，指示文字軌道資料的語言。

HTMLTrackElement.label

一個字串，反映了 label HTML 屬性，指示軌道的使用者可讀標題。

HTMLTrackElement.default

一個布林值，反映了 default 屬性，表示如果使用者的偏好設定沒有指示其他軌道更合適，則啟用該軌道。

HTMLTrackElement.readyState 只讀

返回一個 unsigned short，顯示軌道的就緒狀態。

常量	值	描述
NONE	0	表示尚未獲取文字軌道的提示資訊。
LOADING	1	表示文字軌道正在載入，並且到目前為止沒有遇到任何致命錯誤。解析器可能仍會向軌道新增其他提示資訊。
LOADED	2	表示文字軌道已成功載入，沒有致命錯誤。
ERROR	3	表示文字軌道已被啟用，但在使用者代理嘗試獲取時，發生了一些失敗。部分或全部提示資訊很可能丟失，並且無法獲取。

HTMLTrackElement.track 只讀

返回 TextTrack，這是軌道元素的文字軌道資料。

例項方法

無特定方法；從其父級 HTMLElement 繼承方法。

事件

繼承其父級 HTMLElement 的事件。

使用 addEventListener() 或將事件監聽器分配給此介面的 oneventname 屬性來監聽這些事件

cuechange

當底層的 TextTrack 更改了當前顯示的提示資訊時傳送。此事件始終傳送到 TextTrack，但如果 HTMLTrackElement 與該軌道相關聯，也會傳送到 HTMLTrackElement。您也可以使用 oncuechange 事件處理程式為該事件設定處理程式。

用法說明

載入軌道的文字資源

如果軌道的 mode 最初設定為 disabled 狀態，那麼描述文字軌道實際提示資訊的 WebVTT 或 TTML 資料將不會被載入。如果您需要在設定 <track> 元素後對其執行任何處理，則應確保軌道的 mode 設定為 hidden（如果您不希望一開始就向用戶顯示該軌道）或 showing（以初始顯示該軌道）。之後，您可以根據需要更改模式。

規範

瀏覽器相容性

另見

• 實現此介面的 HTML 元素：<track>。