From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/trackevent/index.html | 116 ++++++++++++++++++++++ files/ja/web/api/trackevent/track/index.html | 56 +++++++++++ files/ja/web/api/trackevent/trackevent/index.html | 74 ++++++++++++++ 3 files changed, 246 insertions(+) create mode 100644 files/ja/web/api/trackevent/index.html create mode 100644 files/ja/web/api/trackevent/track/index.html create mode 100644 files/ja/web/api/trackevent/trackevent/index.html (limited to 'files/ja/web/api/trackevent') diff --git a/files/ja/web/api/trackevent/index.html b/files/ja/web/api/trackevent/index.html new file mode 100644 index 0000000000..dbfefe98c3 --- /dev/null +++ b/files/ja/web/api/trackevent/index.html @@ -0,0 +1,116 @@ +--- +title: TrackEvent +slug: Web/API/TrackEvent +tags: + - API + - Audio + - HTML DOM + - Interface + - Media + - Reference + - TrackEvent + - Video +translation_of: Web/API/TrackEvent +--- +
{{APIRef("HTML DOM")}}
+ +

HTML DOM 仕様の一部である TrackEvent インターフェイスは、HTML メディア要素で使用可能なトラックのセットに対する変更を表すイベントに使用されます。 これらのイベントは {{event("addtrack")}} と {{event("removetrack")}} です。 TrackEvent を {{domxref("RTCPeerConnection")}} の一部であるトラックに使用される {{domxref("RTCTrackEvent")}} インターフェイスと混同しないでください。
+  

+ +

TrackEvent に基づくイベントは、常に次のメディアトラックリストの種類のいずれかに送信されます。

+ + + +
+
+ +

コンストラクタ

+ +
+
{{domxref("TrackEvent.TrackEvent", "TrackEvent()")}}
+
指定されたイベントタイプとオプションの追加プロパティで、新しい TrackEvent オブジェクトを作成して初期化します。
+
+ +

プロパティ

+ +

TrackEvent は {{domxref("Event")}} に基づいているため、Event のプロパティは TrackEvent オブジェクトでも利用できます。

+ +
+
{{domxref("TrackEvent.track", "track")}} {{ReadOnlyInline}}
+
イベントが参照している DOM のトラックオブジェクト。 null でない場合、これは常にメディアトラックの種類のうちの1つのオブジェクト（{{domxref("AudioTrack")}}、{{domxref("VideoTrack")}}、または {{domxref("TextTrack")}}）です。
+
+ +

メソッド

+ +

TrackEvent には独自のメソッドはありません。 しかし、それは {{domxref("Event")}} に基づいているので、Event オブジェクトで利用可能なメソッドを提供します。

+ +

例

+ +

この例では、handleTrackEvent() 関数を設定します。 この関数は、文書内で見つかった最初の {{HTMLElement("video")}} 要素の {{event("addtrack")}} イベントまたは {{event("removetrack")}} イベントに対して呼び出されます。

+ +
var videoElem = document.querySelector("video");
+
+videoElem.videoTracks.addEventListener("addtrack", handleTrackEvent, false);
+videoElem.videoTracks.addEventListener("removetrack", handleTrackEvent, false);
+videoElem.audioTracks.addEventListener("addtrack", handleTrackEvent, false);
+videoElem.audioTracks.addEventListener("removetrack", handleTrackEvent, false);
+videoElem.textTracks.addEventListener("addtrack", handleTrackEvent, false);
+videoElem.textTracks.addEventListener("removetrack", handleTrackEvent, false);
+
+function handleTrackEvent(event) {
+  var trackKind;
+
+  if (event.target instanceof(VideoTrackList)) {
+    trackKind = "動画";
+  } else if (event.target instanceof(AudioTrackList)) {
+    trackKind = "音声";
+  } else if (event.target instanceof(TextTrackList)) {
+    trackKind = "テキスト";
+  } else {
+    trackKind = "不明な";
+  }
+
+  switch(event.type) {
+    case "addtrack":
+      console.log(trackKind + "トラックが追加されました。");
+      break;
+    case "removetrack":
+      console.log(trackKind + "トラックが取り除かれました。");
+      break;
+  }
+}
+
+ +

イベントハンドラは、JavaScript の instanceof 演算子を使用してイベントが発生したトラックの種類を判断し、それがどの種類のトラックであるか、および要素に追加されているのか、要素から取り除かれているのかを示すメッセージをコンソールに出力します。

+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('HTML WHATWG', "media.html#the-trackevent-interface", "TrackEvent")}}{{Spec2('HTML WHATWG')}}初期定義
{{SpecName('HTML5 W3C', "embedded-content-0.html#trackevent", "TrackEvent")}}{{Spec2('HTML5 W3C')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.TrackEvent")}}

diff --git a/files/ja/web/api/trackevent/track/index.html b/files/ja/web/api/trackevent/track/index.html new file mode 100644 index 0000000000..72a0f6f9c7 --- /dev/null +++ b/files/ja/web/api/trackevent/track/index.html @@ -0,0 +1,56 @@ +--- +title: TrackEvent.track +slug: Web/API/TrackEvent/track +tags: + - API + - Audio + - Event + - HTML DOM + - Media + - Property + - Read-only + - Reference + - TrackEvent + - Video + - track +translation_of: Web/API/TrackEvent/track +--- +
{{APIRef("HTML DOM")}}
+ +

{{domxref("TrackEvent")}} インターフェイスの読み取り専用の track プロパティは、イベントが適用されるメディアトラックオブジェクトを指定します。 これは {{domxref("AudioTrack")}}、{{domxref("VideoTrack")}}、または {{domxref("TextTrack")}} のオブジェクトになります。

+ +

構文

+ +
track = TrackEvent.track;
+ +

値

+ +

トラックで表されるメディアの種類に応じて、{{domxref("AudioTrack")}}、{{domxref("VideoTrack")}}、または {{domxref("TextTrack")}} のいずれかの種類のオブジェクトです。 これは、イベントが適用されるトラックを識別します。

+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('HTML WHATWG', "media.html#dom-trackevent-track", "TrackEvent.track")}}{{Spec2('HTML WHATWG')}}初期定義
{{SpecName('HTML5 W3C', "embedded-content-0.html#dom-trackevent-track", "TrackEvent.track")}}{{Spec2('HTML5 W3C')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.TrackEvent.track")}}

diff --git a/files/ja/web/api/trackevent/trackevent/index.html b/files/ja/web/api/trackevent/trackevent/index.html new file mode 100644 index 0000000000..622f86dfbe --- /dev/null +++ b/files/ja/web/api/trackevent/trackevent/index.html @@ -0,0 +1,74 @@ +--- +title: TrackEvent() +slug: Web/API/TrackEvent/TrackEvent +tags: + - API + - Audio + - Constructor + - HTML DOM + - Media + - Reference + - TrackEvent + - Tracks + - Video +translation_of: Web/API/TrackEvent/TrackEvent +--- +
{{APIRef("HTML DOM")}}
+ +

TrackEvent() コンストラクタは、トラックのリスト（{{domxref("AudioTrackList")}}、{{domxref("VideoTrackList")}}、または {{domxref("TextTrackList")}}）で発生したイベントを記述する新しい {{domxref("TrackEvent")}} オブジェクトを作成して返します。

+ +

構文

+ +
trackEvent = new TrackEvent(type, eventInfo);
+ +

パラメーター

+ +
+
type
+
オブジェクトによって記述されるトラックイベントの種類: "addtrack" または "removetrack"。
+
eventInfo {{optional_inline}}
+
新しいイベントを構成する追加情報を提供するオプションの辞書。 次のフィールドを自由に組み合わせて含めることができます。 +
+
track {{optional_inline}}
+
イベントが参照するトラック。 これはデフォルトでは null ですが、トラックの種類に応じて {{domxref("VideoTrack")}}、{{domxref("AudioTrack")}}、または {{domxref("TextTrack")}} に設定する必要があります。
+
bubbles {{optional_inline}}
+
イベントをバブリングするかどうかを示す Boolean。
+
cancelable {{optional_inline}}
+
イベントをキャンセルできるかどうかを示す Boolean。
+
composed {{optional_inline}}
+
イベントがシャドウルートの外側でリスナーをトリガーするかどうかを示す Boolean。 詳細については {{domxref("Event.composed")}} をご覧ください。
+
+
+
+ +

戻り値

+ +

新しく作成された {{domxref("TrackEvent")}} オブジェクト。 コンストラクタへの入力の説明に従って初期化されます。

+ +

仕様

+ + + + + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('HTML WHATWG', "media.html#dom-trackevent-trackevent", "TrackEvent()")}}{{Spec2('HTML WHATWG')}}初期定義
{{SpecName('HTML5 W3C', "semantics-embedded-content.html#dom-trackevent-trackevent", "TrackEvent()")}}{{Spec2('HTML5 W3C')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.TrackEvent.TrackEvent")}}

-- cgit v1.2.3-54-g00ecf