HTMLMediaElement: addTextTrack() 方法

Baseline 已廣泛支援

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來，各瀏覽器均已提供此特性。

addTextTrack() 方法是 HTMLMediaElement 介面的一個方法，用於建立一個新的 TextTrack 物件並將其新增到媒體元素中。它會在該媒體元素的 textTracks 上觸發一個 addtrack 事件。此方法不能在 TextTrackList 介面上使用，只能在 HTMLMediaElement 上使用。

語法

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

引數

kind: 一個字串，表示 TextTrack.kind 屬性（subtitles、captions、descriptions、chapters 或 metadata）。
label: 一個字串，表示 TextTrack.label 屬性。
language: 一個字串，表示 TextTrack.language 屬性。

返回值

新建立的 TextTrack 物件。

異常

無。

示例

此示例添加了一個 kind 設定為 "subtitles" 的新 TextTrack，並向其添加了一個新的 VTTCue。

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

瀏覽器相容性

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2024 年 12 月 19 日，由 MDN 貢獻者進行。

在 GitHub 上檢視此頁面 • 報告此內容的問題