--- title: ': Встраиваемая текстовая дорожка' slug: Web/HTML/Element/track tags: - Element - HTML - HTML embedded content - HTML5 - Multimedia - Reference - TextTrack - Web - Веб - Справка - Элемент translation_of: Web/HTML/Element/track ---
{{HTMLRef}}

HTML-элемент <track>  используется как дочерний элемент медиа-элементов {{HTMLElement("audio")}} and {{HTMLElement("video")}}. Позволяет указать синхронизированные текстовые дорожки (или данные на основе времени), например, для автоматической обработки субтитров. Файлы треков используют формат WebVTT (.vtt файлы) — Web Video Text Tracks или Timed Text Markup Language (TTML).

{{EmbedInteractiveExample("pages/tabbed/track.html", "tabbed-standard")}}
Категории контента Нет
Разрешённое содержимое Нет, это {{Glossary("empty element", "пустой элемент")}}.
Пропуск тегов Так как это пустой элемент, то открывающий тег обязателен, закрывающего не должно быть.
Неявная ARIA-роль Нет соответствующей роли
Разрешённые родители Медиа элемент, перед любым потоковым контентом.
Разрешённые ARIA-роли Нет
DOM интерфейс {{domxref("HTMLTrackElement")}}

Атрибуты

Этот элемент использует глобальные атрибуты.

{{htmlattrdef("default")}}
Этот атрибут указывает, что дорожка должна быть включена, если пользовательские настройки не указывают, что другая дорожка является более подходящей. Может использоваться только для одного элемента track в элементе мультимедиа.
{{htmlattrdef("kind")}}
Как текстовый трек должен быть использован. Если значение опущено, тип по умолчанию — subtitles (субтитры). Если атрибут отсутствует, будет использоваться subtitles. Если атрибут содержит недопустимое значение, оно принимает значение metadata. (Версии Chrome ранее 52 рассматривали недопустимое значение как subtitles.) Допускаются следующие ключевые слова:
{{htmlattrdef("label")}}
Видимый пользователю заголовок текстовой дорожки, который используется браузером при выводе списка доступных текстовых дорожек.
{{htmlattrdef("src")}}
Адрес файла текстовой дорожки (.vtt файл). Должен быть действительным URL. Этот атрибут должен быть указан, а его значение URL должно иметь то же происхождение, что и документ — исключая случаи, когда родительский {{HTMLElement("audio")}} или {{HTMLElement("video")}} данного track элемента имеет атрибут crossorigin.
{{htmlattrdef("srclang")}}
Язык текстовых данных трека. Это должен быть валидный BCP 47 языковой тег (см. также языковые тэги в HTML и XML). Если для атрибута kind установлено значение subtitles, должен быть определён атрибут srclang.

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

Типы данных дорожки

Тип данных, которые трек добавляет на носитель, задаётся в атрибуте kind, который может принимать значения subtitles, captions, descriptions, chapters или metadata. Элемент указывает на исходный файл, содержащий синхронизированный по времени текст, который браузер предоставляет, когда пользователь запрашивает дополнительные данные.

Отдельный media элемент не может иметь элементы track с одинаковыми значениями kind, srclang и label.

Обнаружение изменений сигнала

{{page("/ru/docs/Web/API/TextTrack/cuechange_event", "On the track element")}}

Пример

<video controls poster="/images/sample.gif">
   <source src="sample.mp4" type="video/mp4">
   <source src="sample.ogv" type="video/ogv">
   <track kind="captions" src="sampleCaptions.vtt" srclang="en">
   <track kind="descriptions"
     src="sampleDescriptions.vtt" srclang="en">
   <track kind="chapters" src="sampleChapters.vtt" srclang="en">
   <track kind="subtitles" src="sampleSubtitles_de.vtt" srclang="de">
   <track kind="subtitles" src="sampleSubtitles_en.vtt" srclang="en">
   <track kind="subtitles" src="sampleSubtitles_ja.vtt" srclang="ja">
   <track kind="subtitles" src="sampleSubtitles_oz.vtt" srclang="oz">
   <track kind="metadata" src="keyStage1.vtt" srclang="en"
     label="Key Stage 1">
   <track kind="metadata" src="keyStage2.vtt" srclang="en"
     label="Key Stage 2">
   <track kind="metadata" src="keyStage3.vtt" srclang="en"
     label="Key Stage 3">
   <!-- Fallback -->
   ...
</video>

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

{{Specifications}}

Поддержка браузерами

{{Compat("html.elements.track")}}

Смотрите также