HTMLMediaElement: phương thức addTextTrack()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Phương thức addTextTrack() của giao diện HTMLMediaElement tạo một đối tượng TextTrack mới và thêm nó vào thành phần media. Nó kích hoạt một sự kiện addtrack trên textTracks của thành phần truyền thông này. Không thể sử dụng phương pháp này trên giao diện TextTrackList, chỉ có thể sử dụng HTMLMediaElement.

Cú pháp

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

Tham số

  • kind
  • : Một chuỗi đại diện cho thuộc tính TextTrack.kind (subtitles, captions, descriptions, chapters, hoặc metadata.
  • label
  • : Một chuỗi đại diện cho thuộc tính TextTrack.label.
  • language
  • : Một chuỗi đại diện cho thuộc tính TextTrack.language.

Giá trị trả về

Đối tượng TextTrack mới được tạo.

Ngoại lệ

Không có.

Ví dụ

Ví dụ này thêm TextTrack mới với kind được đặt thành "subtitles" và thêm VTTCue mới vào đó.

js
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!"

Đặc tả kỹ thuật

Specification
HTML
# dom-media-addtexttrack-dev

Tương thích trình duyệt

Xem thêm