HTMLMediaElement : méthode addTextTrack()
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode addTextTrack() de l'interface HTMLMediaElement crée un nouvel objet TextTrack et l'ajoute à l'élément média. Elle déclenche un évènement addtrack sur la propriété textTracks de cet élément média. Cette méthode ne peut pas être utilisée sur une interface TextTrackList, uniquement sur un HTMLMediaElement.
Syntaxe
addTextTrack(kind)
addTextTrack(kind, label)
addTextTrack(kind, label, language)
Paramètres
kind-
Une chaîne de caractères représentant la propriété
TextTrack.kind(subtitles,captions,descriptions,chaptersoumetadata). label-
Une chaîne de caractères représentant la propriété
TextTrack.label. language-
Une chaîne de caractères représentant la propriété
TextTrack.language.
Valeur de retour
Le nouvel objet TextTrack créé.
Exceptions
Aucune.
Exemples
Cet exemple ajoute un nouvel objet TextTrack avec la propriété kind définie sur "subtitles", et ajoute un nouvel objet VTTCue à celui-ci.
const video = document.querySelector("video");
const nouvellePiste = video.addTextTrack("subtitles");
nouvellePiste.addCue(new VTTCue(3, 6, "Bonjour le monde !"));
console.log(nouvellePiste.cues[0].text);
// "Bonjour le monde !"
Spécifications
| Spécification |
|---|
| HTML # dom-media-addtexttrack-dev |
Compatibilité des navigateurs
Voir aussi
- L'interface
TextTrack - L'API WebVTT
- Technologies multimédias Web
- Apprendre : Contenu vidéo et audio
- Utiliser l'API Web Audio