WebVTT(メディアプレゼンテーションに関するテキストトラック)を処理するための API の一部である TextTrack インターフェイスは、特定の <track> 要素に関連付けられたテキストトラックを記述および制御します。

プロパティ

このインターフェイスは EventTarget からもプロパティを継承しています。

TextTrack.activeCues 読取専用
現在アクティブなテキストトラックキューのセットをリストする TextTrackCueList オブジェクト。 メディアの現在の再生位置がキューの開始時間と終了時間の間にある場合、トラックキューはアクティブです。
TextTrack.cues 読取専用
トラックのすべてのキューを含む TextTrackCueList
TextTrack.id 読取専用
トラックがある場合は、それを識別する DOMString。 ID がない場合、この値は空の文字列("")です。 TextTrack<track> 要素に関連付けられている場合、トラックの ID は要素の ID と一致します。
TextTrack.inBandMetadataTrackDispatchType 読取専用
トラックのインバンドメタデータトラックディスパッチタイプ(in-band metadata track dispatch type)を示す DOMString を返します。 詳細が必要
TextTrack.kind 読取専用
TextTrack が記述するテキストトラックの kind を示す DOMString を返します。 値は TextTrackKind 列挙型のいずれかでなければなりません。
TextTrack.label 読取専用
テキストトラックのラベルがあれば、それを含む人間が読める DOMString。 それ以外の場合、これは空の文字列("")になります。 空の文字列の場合、トラックのラベルをユーザーに公開する必要がある場合は、トラックの他の属性を使用してコードでカスタムラベルを生成する必要があります。
TextTrack.language 読取専用
テキストトラックの内容が書かれているテキスト言語を指定する DOMString。 値は、HTML の lang 属性と同じように、IETF の言語を識別するためのタグBCP 47)文書で指定されている形式に準拠する必要があります。 例えば、米国英語の場合は "en-US"、ブラジルポルトガル語の場合は "pt-BR" になります。
TextTrack.mode
トラックの現在のモードを指定する DOMString。 このプロパティの値を変更すると、トラックの現在のモードが一致するように変更されます。 許容値はテキストトラックモード定数にリストされています。

イベント

cuechange
キューが出入りしたときに発生します。 特定のテキストキューは、キューに入ると表示され、キューから出ると消えます。
oncuechange プロパティからも利用できます。

メソッド

このインターフェイスは EventTarget からもメソッドを継承しています。

TextTrack.addCue()
TextTrackCue オブジェクトとして指定された)キューをトラックのキューのリストに追加します。
TextTrack.removeCue()
トラックのキューのリストから(TextTrackCue オブジェクトとして指定された)キューを取り除きます。

未定

仕様

仕様 状態 コメント
WebVTT: The Web Video Text Tracks Format 勧告候補  

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイル
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung Internet
TextTrackChrome 完全対応 18Edge 完全対応 12Firefox 完全対応 31
補足
完全対応 31
補足
補足 Firefox versions before Firefox 50 didn't display captions when playing media without one or more video tracks being played.
IE 完全対応 10Opera 完全対応 15Safari 完全対応 6WebView Android 完全対応 4.4Chrome Android 完全対応 18Firefox Android 完全対応 31Opera Android 未対応 なしSafari iOS 完全対応 7.1Samsung Internet Android 完全対応 あり
activeCuesChrome 完全対応 18Edge 完全対応 12Firefox 完全対応 31
補足
完全対応 31
補足
補足 Starting in Firefox 69, cues are no longer incorrectly loaded when the TextTrack's mode is disabled; if that's the case, the returned list is empty.
IE 完全対応 10Opera 完全対応 15Safari 完全対応 6WebView Android 完全対応 4.4Chrome Android 完全対応 18Firefox Android 完全対応 31Opera Android 未対応 なしSafari iOS 完全対応 7.1Samsung Internet Android 完全対応 あり
addCueChrome 完全対応 18Edge 完全対応 12Firefox 完全対応 31IE 完全対応 10Opera 完全対応 15Safari 完全対応 6WebView Android 完全対応 4.4Chrome Android 完全対応 18Firefox Android 完全対応 31Opera Android 未対応 なしSafari iOS 完全対応 7.1Samsung Internet Android 完全対応 あり
cuechange eventChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 31IE ? Opera ? Safari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 31Opera Android 未対応 なしSafari iOS ? Samsung Internet Android 完全対応 あり
cuesChrome 完全対応 18Edge 完全対応 12Firefox 完全対応 31
補足
完全対応 31
補足
補足 Starting in Firefox 69, cues are no longer incorrectly loaded when the TextTrack's mode is disabled; if that's the case, the returned list is empty.
IE 完全対応 10Opera 完全対応 15Safari 完全対応 6WebView Android 完全対応 4.4Chrome Android 完全対応 18Firefox Android 完全対応 31Opera Android 未対応 なしSafari iOS 完全対応 7.1Samsung Internet Android 完全対応 あり
idChrome 完全対応 18Edge 完全対応 12Firefox 完全対応 31IE 完全対応 10Opera 完全対応 15Safari 完全対応 6WebView Android 完全対応 4.4Chrome Android 完全対応 18Firefox Android 完全対応 31Opera Android 未対応 なしSafari iOS 完全対応 7.1Samsung Internet Android 完全対応 あり
inBandMetadataTrackDispatchTypeChrome 完全対応 18Edge 完全対応 12Firefox 完全対応 31IE 完全対応 10Opera 完全対応 15Safari 完全対応 6WebView Android 完全対応 4.4Chrome Android 完全対応 18Firefox Android 完全対応 31Opera Android 未対応 なしSafari iOS 完全対応 7.1Samsung Internet Android 完全対応 あり
kindChrome 完全対応 18Edge 完全対応 12Firefox 完全対応 31IE 完全対応 10Opera 完全対応 15Safari 完全対応 6WebView Android 完全対応 4.4Chrome Android 完全対応 18Firefox Android 完全対応 31Opera Android 未対応 なしSafari iOS 完全対応 7.1Samsung Internet Android 完全対応 あり
labelChrome 完全対応 18Edge 完全対応 12Firefox 完全対応 31IE 完全対応 10Opera 完全対応 15Safari 完全対応 6WebView Android 完全対応 4.4Chrome Android 完全対応 18Firefox Android 完全対応 31Opera Android 未対応 なしSafari iOS 完全対応 7.1Samsung Internet Android 完全対応 あり
languageChrome 完全対応 18Edge 完全対応 12Firefox 完全対応 31IE 完全対応 10Opera 完全対応 15Safari 完全対応 6WebView Android 完全対応 4.4Chrome Android 完全対応 18Firefox Android 完全対応 31Opera Android 未対応 なしSafari iOS 完全対応 7.1Samsung Internet Android 完全対応 あり
modeChrome 完全対応 18Edge 完全対応 12Firefox 完全対応 31
補足
完全対応 31
補足
補足 Before Firefox 52, using JavaScript to change the mode of a text track that's part of a media element would send one change event to the element's textTracks TextTrackList for each change, even if mutliple changes are made in a single pass through the Firefox event loop. Starting in Firefox 52, these changes are reflected by a single event.
IE 完全対応 10Opera 完全対応 15Safari 完全対応 6WebView Android 完全対応 4.4Chrome Android 完全対応 18Firefox Android 完全対応 31Opera Android 未対応 なしSafari iOS 完全対応 7.1Samsung Internet Android 完全対応 あり
oncuechangeChrome 完全対応 ありEdge 完全対応 12Firefox 完全対応 31IE ? Opera 完全対応 ありSafari 完全対応 ありWebView Android 完全対応 ありChrome Android 完全対応 ありFirefox Android 完全対応 31Opera Android 未対応 なしSafari iOS ? Samsung Internet Android 完全対応 あり
removeCueChrome 完全対応 18Edge 完全対応 12Firefox 完全対応 31IE 完全対応 10Opera 完全対応 15Safari 完全対応 6WebView Android 完全対応 4.4Chrome Android 完全対応 18Firefox Android 完全対応 31Opera Android 未対応 なしSafari iOS 完全対応 7.1Samsung Internet Android 完全対応 あり
sourceBufferChrome 未対応 なしEdge ? Firefox ? IE ? Opera ? Safari 完全対応 ありWebView Android 未対応 なしChrome Android 未対応 なしFirefox Android ? Opera Android 未対応 なしSafari iOS ? Samsung Internet Android ?

凡例

完全対応  
完全対応
未対応  
未対応
実装状況不明  
実装状況不明
実装ノートを参照してください。
実装ノートを参照してください。

関連情報

ドキュメントのタグと貢献者

このページの貢献者: Wind1808, fscholz
最終更新者: Wind1808,