HTMLTrackElement
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を返します。定数 値 説明 NONE0 テキストトラックのキューが得られていないことを示します。 LOADING1 テキストトラックが読み込まれ、今のところ致命的なエラーはないことを示します。パーサーによって、さらにキューがトラックに追加されるかもしれません。 LOADED2 テキストトラックが致命的なエラーなしに読み込まれたことを示します。 ERROR3 テキストトラックが有効であったが,ユーザーエージェントがそれを取得しようとしたとき,これが何らかの形で失敗したことを示す。一部または全部のキューが欠落している可能性が高く、取得できない。 HTMLTrackElement.track読取専用-
track 要素のテキストトラックデータである
TextTrackを返します。
メソッド
固有のメソッドはありません。親である HTMLElement からメソッドを継承しています。
イベント
親である HTMLElement で発生する可能性があるイベントに加えて、以下のイベントが <track> 要素で発生する可能性があります。
使用上のメモ
トラックのテキストリソースの読み込み
トラックの mode が初期状態で disabled になっていると、テキストトラックの実際のキューを記述した WebVTT や TTML データは読み込まれません。もし <track> が設定された後にトラックに対して何らかの処理を行う必要がある場合は、代わりにトラックの mode が hidden (最初からユーザーに表示したくない場合)か showing (最初にトラックを表示する場合)のどちらかになるようにしなければなりません。モードは後で好きなように変更することができます。
仕様書
| Specification |
|---|
| HTML Standard # htmltrackelement |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
- このインターフェイスを実装している HTML 要素:
<track>