1. ウェブ
  2. Web API
  3. HTMLMediaElement
  4. addTextTrack()

このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

HTMLMediaElement: addTextTrack() メソッド

Baseline
広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年7月以降、すべてのブラウザーで利用可能です。

addTextTrack() は HTMLMediaElement インターフェイスのメソッドで、新しい TextTrack オブジェクトを作成し、それをこのメディア要素に追加します。このメソッドは、 addtrack イベントをこのメディア要素の textTracks で発行します。このメソッドは、 TextTrackList インターフェイスでは使用できません。 HTMLMediaElement でのみ使用できます。

構文

js
addTextTrack(kind)
addTextTrack(kind, label)
addTextTrack(kind, label, language)

引数

kind

文字列で、 TextTrack.kind プロパティ (subtitles, captions, descriptions, chapters, metadata) を表します。

label

文字列で、 TextTrack.label プロパティを表します。

language

文字列で、 TextTrack.language プロパティを表します。

返値

新しく作成された TextTrack オブジェクトです。

例外

なし。

例

この例では、新しい TextTrack を、 kind を "subtitles" に設定して追加し、それに新しい VTTCue を追加しています。

js
const video = document.querySelector("video");
const newTrack = video.addTextTrack("subtitles");
newTrack.addCue(new VTTCue(3, 6, "Hello world!"));
console.log(newTrack.cues[0].text);
// "Hello world!"

仕様書

仕様書
HTML
# dom-media-addtexttrack-dev

ブラウザーの互換性

関連情報

MDN の改良に協力

協力方法を知る

このページは MDN の貢献者によって に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告