HTMLTrackElement

インスタンスプロパティ

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

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

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

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

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

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

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

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

インスタンスメソッド

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

イベント

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

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

使用上のメモ

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

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

仕様書

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

関連情報

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