HTMLTrackElement

Базовая Широко доступная

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

Интерфейс HTMLTrackElement представляет собой элемент HTML <track> в DOM. Этот элемент может быть дочерним элементом как для <audio>, так и для <video>, для указания текстовой дорожки, содержащей информацию, такую как субтитры или титры.

Свойства экземпляра

Наследует свойства от родительского класса, HTMLElement.

HTMLTrackElement.kind

Строка, отражающая атрибут HTML kind, указывающий, как использовать текстовую дорожку. Возможные значения: subtitles, captions, descriptions, chapters, или metadata.

HTMLTrackElement.src

Строка, отражающая атрибут HTML src, указывающая адрес данных текстовой дорожки.

HTMLTrackElement.srclang

Строка, отражающая атрибут HTML srclang, указывающая язык данных текстовой дорожки.

HTMLTrackElement.label

Строка, отражающая атрибут HTML label, указывающая удобочитаемое имя дорожки для пользователя.

HTMLTrackElement.default

Логическое значение, отражающее атрибут default, указывающее, что дорожка должна быть включена, если предпочтения пользователя не указывают, что другая дорожка более подходящая.

HTMLTrackElement.readyState Только для чтения

Возвращает unsigned short, показывающий состояние готовности дорожки:

Постоянная	Значение	Описание
`NONE`	0	Указывает, что субтитры дорожки ещё не получены.
`LOADING`	1	Указывает, что текстовая дорожка загружается, и до сих пор не было обнаружено критических ошибок. Дальнейшие субтитры могут быть добавлены к дорожке парсером.
`LOADED`	2	Указывает, что текстовая дорожка загружена без критических ошибок.
`ERROR`	3	Указывает, что дорожка была включена, но когда пользовательский агент попытался получить её, это не удалось по каким-либо причинам. Некоторые или все субтитры, вероятно, отсутствуют и не будут получены.

HTMLTrackElement.track Только для чтения

Возвращает TextTrack - данные текстовой дорожки элемента.

Методы экземпляра

Нет специфических методов; наследует методы от родительского класса HTMLElement.

События

Наследует события от родительского класса HTMLElement.

Привязывайте события, используя addEventListener() или присваивая обработчик события к свойству oneventname этого интерфейса:

cuechange: Отправляется, когда базовая TextTrack изменила текущие отображаемые субтитры. Это событие всегда отправляется в TextTrack, но также отправляется в HTMLTrackElement, если он связан с дорожкой. Вы также можете использовать обработчик события oncuechange для установки обработчика для этого события.

Примечания по использованию

Загрузка текстового ресурса дорожки

Данные WebVTT или TTML, описывающие фактические субтитры для текстовой дорожки, не загружаются, если mode дорожки изначально находится в состоянии disabled. Если вам нужно выполнить обработку дорожки после того, как <track> будет настроена, убедитесь, что состояние дорожки mode либо hidden (если вы не хотите, чтобы она сразу отображалась пользователю), либо showing (чтобы сразу отобразить дорожку). Затем вы можете изменить режим по мере необходимости.

Спецификации

Спецификация
HTML # htmltrackelement

Совместимость браузеров

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`HTMLTrackElement`	23	12	31 До Firefox 50, субтитры загружались только если элемент `<track>` был в документе.	12	6	25	31 До Firefox для Android 50, субтитры загружались только если элемент `<track>` был в документе.	12	6	1.5	4.4
`cuechange_event`	32 23 Обработчик событий `oncuechange` не поддерживается.	14	68	19 15 Обработчик событий `oncuechange` не поддерживается. 12–15	10 6 Обработчик событий `oncuechange` не поддерживается.	32 25 Обработчик событий `oncuechange` не поддерживается.	68	19 14 Обработчик событий `oncuechange` не поддерживается. 12–14	10 6 Обработчик событий `oncuechange` не поддерживается.	2.0 1.5 Обработчик событий `oncuechange` не поддерживается.	4.4.3 ≤37 Обработчик событий `oncuechange` не поддерживается.
`default`	23	12	31	12	6	25	31	12	6	1.5	4.4
`kind`	23	12	31	12	6	25	31	12	6	1.5	4.4
`label`	23	12	31	12	6	25	31	12	6	1.5	4.4
`readyState`	23	12	31	12	6	25	31	12	6	1.5	4.4
`src`	23	12	31 До Firefox 50, свойство `src` работало неправильно.	12	6	25	31 До Firefox для Android 50, свойство `src` работало неправильно.	12	6	1.5	4.4
`srclang`	23	12	31	12	6	25	31	12	6	1.5	4.4
`track`	23	12	31	12	6	25	31	12	6	1.5	4.4

См. также

Элемент HTML, реализующий этот интерфейс: <track>.

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLTrackElement