TextTrack: addCue() method

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 addCue() của giao diện TextTrack thêm một cue mới vào danh sách các cue.

Cú pháp

js
addCue(cue)

Tham số

cue

Một TextTrackCue.

Note: Giao diện TextTrackCue là một lớp trừu tượng được dùng làm lớp cha cho các giao diện cue khác như VTTCue. Do đó, khi thêm một cue, bạn sẽ sử dụng một trong các kiểu cue kế thừa từ TextTrackCue.

Giá trị trả về

Undefined.

Ngoại lệ

InvalidStateError DOMException

Ném ra nếu các quy tắc cho TextTrackList này không khớp với những quy tắc phù hợp cho TextTrackCue đến.

Ví dụ

Trong ví dụ sau, hai cue được thêm vào text track của video bằng addCue().

js
let video = document.querySelector("video");
let track = video.addTextTrack("captions", "Captions", "en");
track.mode = "showing";
track.addCue(new VTTCue(0, 0.9, "Hildy!"));
track.addCue(new VTTCue(1, 1.4, "How are you?"));

Thông số kỹ thuật

Thông số kỹ thuật
HTML
# dom-texttrack-addcue-dev

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