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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.