База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

track — синхронизирани текстови писти

Елементът track добавя към аудио или видео външна текстова писта, синхронизирана по време, например субтитри за диалог, субтитри с информация за звуци или метаданни. Сам по себе си той не създава отделен видим елемент.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

<video controls src="movie.webm">
  <track kind="subtitles" src="subtitles.en.vtt" srclang="en" label="English" default>
</video>

track е пряк дъщерен елемент на audio или video. Поставя се след евентуалните елементи source и преди резервното съдържание. Това е празен елемент: няма съдържание и затварящ таг. Задължителният src сочи към данните на пистата, обикновено във формат WebVTT.

kind различава subtitles (диалог), captions (диалог и важни звуци), descriptions (визуални описания, предназначени за синтез на реч), chapters (метаданни за глави) и metadata (данни за скриптове). Ако kind липсва, стойността е subtitles; невалидна стойност означава metadata.

srclang е езиков таг BCP 47 и е задължителен за subtitles. label е име, предназначено за потребителите, и не трябва да е празно, когато е зададено. Булевият атрибут default предлага пистата да бъде включена, но потребителските предпочитания може да имат предимство. За един медиен елемент най-много една писта от общата група subtitles и captions може да има default.

В DOM element.track предоставя обект TextTrack, а не HTML елемент. Примерът прочита свойствата му, без да възпроизвежда медия; той не проверява зареждането на cue или показването на субтитри.

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Track inspection</title>
<video>
  <track id="captions" kind="captions" srclang="en" label="English" src="data:text/vtt,WEBVTT%0A%0A00%3A00%3A00.000%20--%3E%2000%3A00%3A02.000%0AHello.%0A">
</video>
<pre id="result"></pre>
<script>
  const element = document.getElementById('captions');
  document.getElementById('result').textContent = [
    element.tagName,
    element.track.kind,
    element.track.language,
    element.track.label
  ].join(' | ');
</script>
</html>

Резултат

TRACK | captions | en | English

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници