HTMLTrackElement
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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
で発生する可能性があるイベントに加えて、以下のイベントが発生する可能性があります。
使用上のメモ
トラックのテキストリソースの読み込み
トラックの mode
が初期状態で disabled
になっていると、テキストトラックの実際のキューを記述した WebVTT や TTML データは読み込まれません。もし <track>
が設定された後にトラックに対して何らかの処理を行う必要がある場合は、代わりにトラックの mode
が hidden
(最初からユーザーに表示したくない場合)か showing
(最初にトラックを表示する場合)のどちらかになるようにしなければなりません。モードは後で好きなように変更することができます。
仕様書
Specification |
---|
HTML Standard # htmltrackelement |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- このインターフェイスを実装している HTML 要素:
<track>