このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
HTMLMediaElement: addTextTrack() メソッド
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
addTextTrack() はHTMLMediaElement インターフェイスのメソッドで、新しいTextTrack オブジェクトを作成し、それをこのメディア要素に追加します。このメソッドは、addtrack イベントをこのメディア要素のtextTracks で発行します。このメソッドは、TextTrackList インターフェイスでは使用できません。HTMLMediaElement でのみ使用できます。
構文
js
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 を追加しています。
js
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!"仕様書
| Specification |
|---|
| HTML # dom-media-addtexttrack-dev |