Список следов текста

Интерфейс TextTrackList используется для представления списка следов текста, определенных для связанного видео- или аудиоэлемента, где каждый след представлен отдельным объектом textTrack в списке.

Следы текста можно добавлять в элемент мультимедиа декларативно, используя элемент <track>, или программно, используя метод HTMLMediaElement.addTextTrack().

Экземпляр этого объекта можно получить, используя свойство textTracks объекта HTMLMediaElement.

Для данного объекта HTMLMediaElement media, к отдельным следам можно получить доступ, используя:

• media.TextTracks[n], для получения n-го следа текста из списка следов текста объекта
• метод media.textTracks.getTrackById()

Этот интерфейс также наследует свойства от своего родительского интерфейса, EventTarget.

length Только для чтения

Количество следов в списке.

Этот интерфейс также наследует методы от своего родительского интерфейса, EventTarget.

getTrackById()

Возвращает TextTrack, найденный в TextTrackList, чей id совпадает с указанной строкой. Если совпадение не найдено, возвращается null.

addtrack

Срабатывает, когда новый след текста добавлен к элементу мультимедиа. Также доступен через свойство onaddtrack.

change

Срабатывает, когда след текста стал активным или неактивным. Также доступен через свойство onchange.

removetrack

Срабатывает, когда след текста был удален из элемента мультимедиа. Также доступен через свойство onremovetrack.

Помимо возможности получить прямой доступ к следам текста, присутствующим в элементе мультимедиа, TextTrackList позволяет устанавливать обработчики событий для событий addtrack и removetrack, чтобы вы могли обнаруживать добавление или удаление следов из потока элемента мультимедиа.

Чтобы получить список следов текста элемента мультимедиа, используйте его свойство textTracks.

const textTracks = document.querySelector("video").textTracks;

В этом примере у нас есть приложение, которое отображает информацию о доступных каналах. Чтобы приложение оставалось актуальным, устанавливаются обработчики событий addtrack и removetrack.

textTracks.onaddtrack = updateTrackCount;
textTracks.onremovetrack = updateTrackCount;

function updateTrackCount(event) {
  trackCount = textTracks.length;
  drawTrackCountIndicator(trackCount);
}