HTMLTrackElement: sự kiện cuechange

Baseline Widely available

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

Sự kiện cuechange kích hoạt khi một TextTrack đã thay đổi các cue đang hiển thị. Sự kiện được kích hoạt trên cả TextTrackHTMLTrackElement nơi nó đang được trình bày, nếu có.

Cú pháp

Sử dụng tên sự kiện trong các phương thức như addEventListener(), hoặc đặt thuộc tính trình xử lý sự kiện.

js
addEventListener("cuechange", (event) => { })

oncuechange = (event) => { }

Kiểu sự kiện

Một Event chung không có thuộc tính bổ sung.

Ví dụ

TextTrack bên dưới, được chỉ ra bởi thuộc tính track, nhận sự kiện cuechange mỗi khi cue đang trình bày thay đổi. Điều này xảy ra ngay cả khi track không liên kết với phần tử media.

Nếu track được liên kết với phần tử media, sử dụng phần tử <track> như một phần tử con của <audio> hoặc <video>, sự kiện cuechange cũng được gửi đến HTMLTrackElement.

js
let textTrackElem = document.getElementById("text-track");

textTrackElem.addEventListener("cuechange", (event) => {
  let cues = event.target.track.activeCues;
});

Hoặc, bạn có thể sử dụng trình xử lý sự kiện oncuechange:

js
let textTrackElem = document.getElementById("text-track");

textTrackElem.oncuechange = (event) => {
  let cues = event.target.track.activeCues;
};

Thông số kỹ thuật

Thông số kỹ thuật
HTML
# event-media-cuechange
HTML
# handler-oncuechange

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

Xem thêm