← 返回首页
HTMLMediaElement : méthode addTextTrack() - Les API Web | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Basculer la barre latérale
  1. Web
  2. Les API Web
  3. HTMLMediaElement
  4. addTextTrack()
Thème
  • Automatique
  • Clair
  • Sombre
Français
Se souvenir de la langue En savoir plus

Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

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.

Dans cet article

Syntaxe

js
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, chapters ou metadata).

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.

js
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

Activez JavaScript pour afficher ce tableau de compatibilité des navigateurs.

Voir aussi

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?
Oui Non
Apprendre à contribuer

Cette page a été modifiée le 19 avr. 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu
  1. API HTML DOM
  2. HTMLMediaElement
  3. Propriétés d'instance
    1. audioTracks
    2. autoplay
    3. buffered
    4. controller
    5. controls
    6. controlsList
    7. crossOrigin
    8. currentSrc
    9. currentTime
    10. defaultMuted
    11. defaultPlaybackRate
    12. disableRemotePlayback
    13. duration
    14. ended
    15. error
    16. loading
    17. loop
    18. mediaGroup
    19. mediaKeys
    20. muted
    21. networkState
    22. paused
    23. playbackRate
    24. played
    25. preload
    26. preservesPitch
    27. readyState
    28. remote
    29. seekable
    30. seeking
    31. sinkId
    32. src
    33. srcObject
    34. textTracks
    35. videoTracks
    36. volume
  4. Méthodes d'instance
    1. addTextTrack()
    2. canPlayType()
    3. captureStream()
    4. fastSeek()
    5. getStartDate()
    6. load()
    7. pause()
    8. play()
    9. seekToNextFrame()
    10. setMediaKeys()
    11. setSinkId()
  5. Évènements
    1. abort
    2. canplay
    3. canplaythrough
    4. durationchange
    5. emptied
    6. encrypted
    7. ended
    8. error
    9. loadeddata
    10. loadedmetadata
    11. loadstart
    12. pause
    13. play
    14. playing
    15. progress
    16. ratechange
    17. seeked
    18. seeking
    19. stalled
    20. suspend
    21. timeupdate
    22. volumechange
    23. waiting
    24. waitingforkey
  6. Héritage
    1. HTMLElement
    2. Element
    3. Node
    4. EventTarget
  7. Pages liées à HTML DOM
    1. BeforeUnloadEvent
    2. DOMStringMap
    3. ErrorEvent
    4. HTMLAnchorElement
    5. HTMLAreaElement
    6. HTMLAudioElement
    7. HTMLBRElement
    8. HTMLBaseElement
    9. HTMLBodyElement
    10. HTMLButtonElement
    11. HTMLCanvasElement
    12. HTMLDListElement
    13. HTMLDataElement
    14. HTMLDataListElement
    15. HTMLDialogElement
    16. HTMLDivElement
    17. HTMLDocument
    18. HTMLElement
    19. HTMLEmbedElement
    20. HTMLFieldSetElement
    21. HTMLFormControlsCollection
    22. HTMLFormElement
    23. HTMLFrameSetElement
    24. HTMLGeolocationElement
    25. HTMLHRElement
    26. HTMLHeadElement
    27. HTMLHeadingElement
    28. HTMLHtmlElement
    29. HTMLIFrameElement
    30. HTMLImageElement
    31. HTMLInputElement
    32. HTMLLIElement
    33. HTMLLabelElement
    34. HTMLLegendElement
    35. HTMLLinkElement
    36. HTMLMapElement
    37. HTMLMenuElement
    38. HTMLMetaElement
    39. HTMLMeterElement
    40. HTMLModElement
    41. HTMLOListElement
    42. HTMLObjectElement
    43. HTMLOptGroupElement
    44. HTMLOptionElement
    45. HTMLOptionsCollection
    46. HTMLOutputElement
    47. HTMLParagraphElement
    48. HTMLPictureElement
    49. HTMLPreElement
    50. HTMLProgressElement
    51. HTMLQuoteElement
    52. HTMLScriptElement
    53. HTMLSelectElement
    54. HTMLSourceElement
    55. HTMLSpanElement
    56. HTMLStyleElement
    57. HTMLTableCaptionElement
    58. HTMLTableCellElement
    59. HTMLTableColElement
    60. HTMLTableElement
    61. HTMLTableRowElement
    62. HTMLTableSectionElement
    63. HTMLTemplateElement
    64. HTMLTextAreaElement
    65. HTMLTimeElement
    66. HTMLTitleElement
    67. HTMLTrackElement
    68. HTMLUListElement
    69. HTMLUnknownElement
    70. HTMLVideoElement
    71. HashChangeEvent
    72. History
    73. ImageData
    74. Location
    75. MessageChannel
    76. MessageEvent
    77. MessagePort
    78. Navigator
    79. PageRevealEvent
    80. PageSwapEvent
    81. PageTransitionEvent
    82. Plugin
    83. PluginArray
    84. PromiseRejectionEvent
    85. RadioNodeList
    86. TimeRanges
    87. UserActivation
    88. ValidityState
    89. Window
    90. WorkletGlobalScope
  8. Guides
    1. Utiliser les microtâches en JavaScript avec queueMicrotask()
    2. Aller plus loin : Les microtâches et l'environnement d'exécution JavaScript

Votre modèle pour un internet meilleur.

MDN Contribuer Développeur·euse·s

Visitez la société mère à but non lucratif de Mozilla Corporation, la Fondation Mozilla.
Certaines parties de ce contenu sont protégées par le droit d'auteur ©1998—2026 des contributeurs individuels de mozilla.org. Contenu disponible sous une licence Creative Commons.