HTMLTrackElement

Thuộc tính phiên bản

Kế thừa các thuộc tính từ phần tử cha, HTMLElement.

HTMLTrackElement.kind

Một chuỗi phản ánh thuộc tính HTML kind, cho biết text track được sử dụng như thế nào. Các giá trị có thể là: subtitles, captions, descriptions, chapters hoặc metadata.

HTMLTrackElement.src

Một chuỗi phản ánh thuộc tính HTML src, cho biết địa chỉ của dữ liệu text track.

HTMLTrackElement.srclang

Một chuỗi phản ánh thuộc tính HTML srclang, cho biết ngôn ngữ của dữ liệu text track.

HTMLTrackElement.label

Một chuỗi phản ánh thuộc tính HTML label, cho biết tiêu đề mà người dùng có thể đọc được của track.

HTMLTrackElement.default

Một giá trị boolean phản ánh thuộc tính default, cho biết rằng track sẽ được bật nếu tùy chọn của người dùng không chỉ ra rằng một track khác sẽ phù hợp hơn.

HTMLTrackElement.readyState Read only

Trả về một unsigned short cho thấy trạng thái sẵn sàng của track:

Hằng số	Giá trị	Mô tả
NONE	0	Cho biết các cue của text track chưa được tải.
LOADING	1	Cho biết text track đang được tải và chưa gặp lỗi nghiêm trọng nào. Các cue có thể vẫn được thêm vào track bởi trình phân tích cú pháp.
LOADED	2	Cho biết text track đã được tải mà không có lỗi nghiêm trọng nào.
ERROR	3	Cho biết text track đã được bật, nhưng khi user agent cố gắng lấy nó, điều này đã thất bại theo một cách nào đó. Một số hoặc tất cả các cue có thể bị thiếu và sẽ không được lấy.

HTMLTrackElement.track Read only

Trả về TextTrack là dữ liệu text track của phần tử track.

Phương thức phiên bản

Không có phương thức đặc thù; kế thừa các phương thức từ phần tử cha, HTMLElement.

Sự kiện

Kế thừa các sự kiện từ phần tử cha, HTMLElement.

Nghe các sự kiện này bằng addEventListener() hoặc bằng cách gán trình lắng nghe sự kiện cho thuộc tính oneventname của giao diện này:

cuechange

Được gửi khi TextTrack bên dưới đã thay đổi các cue đang hiển thị. Sự kiện này luôn được gửi đến TextTrack nhưng cũng được gửi đến HTMLTrackElement nếu có phần tử liên quan đến track. Bạn cũng có thể sử dụng trình xử lý sự kiện oncuechange để thiết lập trình xử lý cho sự kiện này.

Ghi chú sử dụng

Tải tài nguyên văn bản của track

Dữ liệu WebVTT hoặc TTML mô tả các cue thực sự cho text track không được tải nếu mode của track ban đầu ở trạng thái disabled. Nếu bạn cần xử lý track sau khi <track> được thiết lập, bạn nên đảm bảo rằng mode của track là hidden (nếu bạn không muốn nó bắt đầu được trình bày cho người dùng) hoặc showing (để hiển thị track ban đầu). Sau đó bạn có thể thay đổi mode theo mong muốn.

Thông số kỹ thuật

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

Xem thêm

• Phần tử HTML triển khai giao diện này: <track>.