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

Интерактивный пример

<video controls src="/shared-assets/videos/friday.mp4">  <track    default    kind="captions"    srclang="en"    src="/shared-assets/misc/friday.vtt" />  Download the  <a href="/shared-assets/videos/friday.mp4">MP4</a>  video, and  <a href="/shared-assets/misc/friday.vtt">subtitles</a>.</video>

video {  width: 250px;}video::cue {  font-size: 1rem;}

Атрибуты

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

default

Этот атрибут указывает, что дорожка должна быть включена, если пользовательские настройки не указывают, что другая дорожка является более подходящей. Может использоваться только для одного элементаtrack в элементе мультимедиа.

kind

Как текстовый трек должен быть использован. Если значение опущено, тип по умолчанию —subtitles (субтитры). Если атрибут отсутствует, будет использоватьсяsubtitles. Если атрибут содержит недопустимое значение, оно принимает значениеmetadata. (Версии Chrome ранее 52 рассматривали недопустимое значение какsubtitles.) Допускаются следующие ключевые слова:

• subtitles

  • Субтитры обеспечивают перевод контента, который не может быть понят зрителем. Например, диалог или текст, который не является английским, в фильме на английском языке.
  • Субтитры могут содержать дополнительный контент, обычно дополнительную справочную информацию. Например, текст в начале фильмов «Звёздных войн» или дата, время и место действия сцены.

• captions

  • Подписи обеспечивают транскрипцию и, возможно, перевод аудио.
  • Подписи могут включать важную невербальную информацию, такую как музыкальные сигналы или звуковые эффекты. Возможно указывать источник сигналов (например, музыка, текст, персонаж).
  • Подходит для пользователей со слабым слухом или когда звук отключён.

• descriptions

  • Текстовое описание видеоконтента.
  • Подходит для слепых пользователей или там, где видео не видно.

• chapters

  • Названия глав предназначены для использования при навигации по медиа-ресурсу.

• metadata

  • Данные, используемые скриптами. Не видны пользователю.

label

Видимый пользователю заголовок текстовой дорожки, который используется браузером при выводе списка доступных текстовых дорожек.

src

Адрес файла текстовой дорожки (.vtt файл). Должен быть действительным URL. Этот атрибут должен быть указан, а его значение URL должно иметь то же происхождение, что и документ — исключая случаи, когда родительский<audio> или<video> данногоtrack элемента имеет атрибутcrossorigin.

srclang

Язык текстовых данных трека. Это должен быть валидныйBCP 47 языковой тег (см. такжеязыковые тэги в HTML и XML). Если для атрибутаkind установлено значениеsubtitles, должен быть определён атрибутsrclang.

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

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

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

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

Пример

<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>

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

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

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

• WebVTT — формат файлов текстовой дорожки
• HTMLMediaElement.textTracks