HTMLMediaElement: метод addTextTrack()

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

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

Метод addTextTrack() интерфейса HTMLMediaElement создаёт новый объект TextTrack и добавляет его к элементу мультимедиа. Он вызывает событие addtrack на списке textTracks этого элемента мультимедиа. Этот метод нельзя использовать с интерфейсом TextTrackList, только с HTMLMediaElement.

Синтаксис

addTextTrack(kind)
addTextTrack(kind, label)
addTextTrack(kind, label, language)

Параметры

kind: Строка, представляющая свойство TextTrack.kind (subtitles, captions, descriptions, chapters, или metadata).
label: Строка, представляющая свойство TextTrack.label.
language: Строка, представляющая свойство TextTrack.language.

Возвращаемое значение

Созданный объект TextTrack.

Исключения

Нет.

Примеры

В этом примере добавляется новый TextTrack с kind установленным в "subtitles", и к нему добавляется новый VTTCue.

const video = document.querySelector("video");
const newTrack = video.addTextTrack("subtitles");
newTrack.addCue(new VTTCue(3, 6, "Hello world!"));
console.log(newTrack.cues[0].text);
// "Hello world!"

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

Спецификация
HTML # dom-media-addtexttrack-dev

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`addTextTrack`	2326	12	31	≤12.1	6	2526	31	≤12.1	6	1.51.5	4.4≤37

См. также

© 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/HTMLMediaElement/addTextTrack