HTMLVideoElement

HTMLVideoElement インターフェイスは、動画ブジェクトを操作するための特別なプロパティとメソッドを提供します。また、 HTMLMediaElement と HTMLElement のプロパティとメソッドを継承しています。

対応しているメディア形式のリストは、ブラウザーによって異なります。動画を提供する際には、関連するすべてのブラウザーが対応している単一の形式で提供するか、対応する必要のあるすべてのブラウザーをカバーするように、異なる形式で複数の動画ソースを提供するかしてください。

プロパティ

_祖先インターフェイスである HTMLMediaElement および HTMLElement からプロパティを継承しています。

HTMLVideoElement.height: DOMString で、 HTML の height 属性を反映し、表示領域の高さを CSS ピクセル数で指定します。
HTMLVideoElement.poster: DOMString で、 HTML の poster 属性を反映し、動画データが利用できないときに表示する画像を指定します。
HTMLVideoElement.videoHeight (en-US) 読取専用: 符号なし整数値で、リソースの内在的な高さを CSS ピクセル数で示す値を返します。メディアが利用できない場合は 0 を返します。
HTMLVideoElement.videoWidth (en-US) 読取専用: 符号なし整数値で、リソースの内在的な幅を CSS ピクセル数で示す値を返します。メディアが利用できない場合は 0 を返します。
HTMLVideoElement.width: DOMString で、 HTML の width 属性を反映し、表示領域の幅を CSS ピクセル数で指定します。
HTMLVideoElement.autoPictureInPicture (en-US): autoPictureInPicture 属性は、ユーザーがタブやアプリケーションを切り替えると、自動的に video 要素のピクチャインピクチャモードに入ったり抜けたりします。
HTMLVideoElement.disablePictureInPicture (en-US): disablePictureInPicture プロパティは、ユーザーにピクチャインピクチャを提案しないようにするか、または自動的に要求するか、ユーザーエージェントにヒントを与えます。

Gecko 固有のプロパティ

HTMLVideoElement.mozParsedFrames 読取専用: unsigned long で、メディアリソースから解析された動画のフレーム数を返します。
HTMLVideoElement.mozDecodedFrames 読取専用: unsigned long で、すでに画像にデコードされた、解析された動画のフレーム数を返します。
HTMLVideoElement.mozPresentedFrames 読取専用: unsigned long で、描画のためにレンダリングパイプラインに提示されたデコード済みのフレーム数を返します。
HTMLVideoElement.mozPaintedFrames 読取専用: unsigned long で、画面上に描画されたフレームの数を返します。
HTMLVideoElement.mozFrameDelay 読取専用: double で、最後にペイントされたビデオフレームの時刻をを秒単位で返します。
HTMLVideoElement.mozHasAudio 読取専用: 論理値で、動画に音声があるかどうかを示す値を返します。

Microsoft 拡張

HTMLVideoElement.msFrameStep() (en-US): 動画を 1 フレーム前、または 1 フレーム後にコマ送りします。
HTMLVideoElement.msHorizontalMirror (en-US): 画面上で video 要素を水平方向に反転させるかどうかを取得または設定します。
HTMLVideoElement.msInsertVideoEffect() (en-US): 指定された動画エフェクトをメディアパイプラインに挿入します。
HTMLVideoElement.msIsLayoutOptimalForPlayback (en-US) 読取専用: 動画をより効率的にレンダリングできるかどうかを示します。
HTMLVideoElement.msIsStereo3D (en-US) 読取専用: 読み込まれた動画ソースがステレオ 3D であるとシステムが判断するかどうかを決定します。true に設定されていると、ソースがステレオ 3D であることを示します。
HTMLVideoElement.msZoom (en-US): 動画フレームを動画の画面に合わせてトリミングするかどうかを制御します。

メソッド

親である HTMLMediaElement とその祖先である HTMLElement からメソッドを継承しています。

HTMLVideoElement.getVideoPlaybackQuality() (en-US): 現在の再生メトリクスを含む VideoPlaybackQuality (en-US) オブジェクトを返します。この情報には、ドロップされたフレーム数や破損したフレーム数、総フレーム数などが含まれます。
HTMLVideoElement.requestPictureInPicture() (en-US): ユーザーエージェントが動画をピクチャーインピクチャーモードにすることをリクエストします。

イベント

親である HTMLMediaElement およびその祖先である HTMLElement からイベントを継承しています。 これらのイベントを待ち受けするには、 addEventListener() を使用するか、イベントリスナーをこのインターフェイスの oneventname に代入するかしてください。

enterpictureinpicture (en-US): ピクチャインピクチャモードになったときに HTMLVideoElement に送信されます。対応するイベントハンドラーは HTMLVideoElement.onenterpictureinpicture (en-US) です。
leavepictureinpicture (en-US): ピクチャインピクチャモードになったときに HTMLVideoElement に送信されます。対応するイベントハンドラーは HTMLVideoElement.onleavepictureinpicture (en-US) です。

仕様書

Specification
HTML Standard (HTML) # htmlvideoelement

ブラウザーの互換性

BCD tables only load in the browser