HTMLMediaElement: thuộc tính textTracks
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.
Chỉ đọc textTracks
thuộc tính trên đối tượng HTMLMediaElement trả về một
TextTrackList object listing all of the TextTrack
các đối tượng đại diện cho các đoạn văn bản của phần tử đa phương tiện, theo thứ tự như trong
danh sách các đoạn văn bản.
Bạn có thể phát hiện khi nào các bản nhạc được thêm vào và xóa khỏi một
<audio> hoặc
phần tử <video>
sử dụng các sự kiện addtrack và removetrack. Tuy nhiên, những điều này
các sự kiện không được gửi trực tiếp đến chính phần tử phương tiện. Thay vào đó, chúng được gửi tới
đối tượng danh sách bài hát của HTMLMediaElement
tương ứng với loại bản nhạc đã được thêm vào phần tử
Danh sách trả về là live; nghĩa là, khi các bản nhạc được thêm vào và xóa khỏi phần tử phương tiện, nội dung của danh sách sẽ thay đổi linh hoạt. Một khi bạn có một tài liệu tham khảo đến danh sách, bạn có thể theo dõi những thay đổi để phát hiện khi nào các đoạn văn bản mới được thêm vào hoặc những cái hiện có bị loại bỏ.
Xem TextTrackList events để tìm hiểu biết thêm về việc theo dõi các thay đổi đối với danh sách theo dõi của phần tử phương tiện.
Giá trị
Đối tượng TextTrackList biểu thị danh sách các bản văn bản có trong thành phần phương tiện. Có thể truy cập danh sách các bản nhạc bằng cách sử dụng textTracks[n] để lấy bản nhạc văn bản thứ n từ danh sách các bản nhạc văn bản của đối tượng hoặc sử dụng textTracks.getTrackById()
phương pháp.
Mỗi bản nhạc được thể hiện bằng một đối tượng TextTrack cung cấp
thông tin về đường đua.
Ví dụ
Chúng tôi bắt đầu với một
<video> có
một số <track>
những đứa trẻ
<video controls>
<source src="/shared-assets/videos/sintel-short.webm" type="video/webm" />
<source src="/shared-assets/videos/sintel-short.mp4" type="video/mp4" />
<track
kind="subtitles"
src="/shared-assets/misc/sintel-en.vtt"
srclang="vi"
label="English" />
<track
kind="subtitles"
src="/shared-assets/misc/sintel-de.vtt"
srclang="de"
label="Deutsch" />
<track
kind="subtitles"
src="/shared-assets/misc/sintel-es.vtt"
srclang="es"
label="Español" />
</video>
HTMLMediaElement.textTracks trả về TextTrackList mà qua đó chúng ta có thể lặp lại. Ở đây chúng tôi đặt cả ba bản nhạc để hiển thị đồng thời.
const tracks = document.querySelector("video").textTracks;
for (const track of tracks) {
track.mode = "showing";
}
Đặc tả kỹ thuật
| Thông số kỹ thuật |
|---|
| HTML # dom-media-texttracks-dev |
Tương thích trình duyệt
Xem thêm
HTMLMediaElement: Giao diện dùng để định nghĩa thuộc tínhHTMLMediaElement.textTracks<audio>,<video>AudioTrack,AudioTrackListVideoTrack,VideoTrackListaddtrack,change,removetrack: Sự kiện AudioTrackListaddtrack,change,removetrack: Sự kiện VideoTrackList