HTMLTrackElement インターフェイスはDOM 内にあるHTML の<track> 要素を表します。この要素は<audio> または<video> の子として使用され、クローズドキャプションや字幕などの情報を含むテキストトラックを指定することが可能です。

インスタンスプロパティ

親であるHTMLElement から継承したプロパティがあります。

HTMLTrackElement.kind

HTML のkind 属性を反映した文字列で、使用する予定のテキストトラックを示します。可能な値はsubtitles,captions,descriptions,chapters,metadata です。

HTMLTrackElement.src

HTML のsrc 属性を反映した文字列で、テキストトラックデータの在りかを示します。

HTMLTrackElement.srclang

HTML のsrclang 属性を反映した文字列で、テキストのトラックデータの言語を示します。

HTMLTrackElement.label

HTML のlabel 属性を反映した文字列で、トラックのユーザーが読めるタイトルを示します。

HTMLTrackElement.default

default 属性を反映した論理値で、ユーザーの環境設定で他のトラックがより適切であることが示されていない場合、そのトラックを有効にすることを示します。

HTMLTrackElement.readyState読取専用

トラックの準備状態を示すunsigned short を返します。

定数	値	説明
NONE	0	テキストトラックのキューが得られていないことを示します。
LOADING	1	テキストトラックが読み込まれ、今のところ致命的なエラーはないことを示します。パーサーによって、さらにキューがトラックに追加されるかもしれません。
LOADED	2	テキストトラックが致命的なエラーなしに読み込まれたことを示します。
ERROR	3	テキストトラックが有効であったが，ユーザーエージェントがそれを取得しようとしたとき，これが何らかの形で失敗したことを示す。一部または全部のキューが欠落している可能性が高く、取得できない。

HTMLTrackElement.track読取専用

track 要素のテキストトラックデータであるTextTrack を返します。

インスタンスメソッド

固有のメソッドはありません。親であるHTMLElement から継承したメソッドがあります。

イベント

<track> 要素では、親であるHTMLElement で発生する可能性があるイベントに加えて、以下のイベントが発生する可能性があります。

cuechange

基礎となるTextTrack が、現在表示されているキューを変更したときに送られます。このイベントは常にTextTrack に送られますが、もしHTMLTrackElement がトラックと関連付けられていれば、そちらにも送られます。また、oncuechange イベントハンドラーを使用して、このイベントのハンドラーを確立することができます。

使用上のメモ

トラックのテキストリソースの読み込み

トラックのmode が初期状態でdisabled になっていると、テキストトラックの実際のキューを記述した WebVTT や TTML データは読み込まれません。もし<track> が設定された後にトラックに対して何らかの処理を行う必要がある場合は、代わりにトラックのmode がhidden （最初からユーザーに表示したくない場合）かshowing （最初にトラックを表示する場合）のどちらかになるようにしなければなりません。モードは後で好きなように変更することができます。

仕様書

ブラウザーの互換性

関連情報

• このインターフェイスを実装している HTML 要素:<track>