HTMLVideoElement

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.

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

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

EventTarget Node Element HTMLElement HTMLMediaElement HTMLVideoElement

インスタンスプロパティ

親インターフェイスである HTMLMediaElement および HTMLElement から継承したプロパティがあります。

HTMLVideoElement.disablePictureInPicture

ユーザーエージェントがユーザーにピクチャインピクチャを提案するかしないかを示します。

HTMLVideoElement.height

文字列で、 HTML の height 属性を反映し、表示領域の高さを CSS ピクセル数で指定します。

HTMLVideoElement.poster

文字列で、 HTML の poster 属性を反映し、動画データが利用できないときに表示する画像を指定します。

HTMLVideoElement.videoHeight 読取専用

符号なし整数値で、リソースの内在的な高さを CSS ピクセル数で示す値を返します。メディアが利用できない場合は 0 を返します。

HTMLVideoElement.videoWidth 読取専用

符号なし整数値で、リソースの内在的な幅を CSS ピクセル数で示す値を返します。メディアが利用できない場合は 0 を返します。

HTMLVideoElement.width

文字列で、HTML の width 属性を反映し、表示領域の幅を CSS ピクセル数で指定します。

Firefox 固有のプロパティ

HTMLVideoElement.mozParsedFrames 非標準 読取専用 非推奨;

unsigned long で、メディアリソースから解析された動画のフレーム数を返します。

HTMLVideoElement.mozDecodedFrames 非標準 読取専用 非推奨;

unsigned long で、すでに画像にデコードされた、解析された動画のフレーム数を返します。

HTMLVideoElement.mozPresentedFrames 非標準 読取専用 非推奨;

unsigned long で、描画のためにレンダリングパイプラインに提示されたデコード済みのフレーム数を返します。

HTMLVideoElement.mozPaintedFrames 非標準 読取専用 非推奨;

unsigned long で、画面上に描画されたフレームの数を返します。

HTMLVideoElement.mozFrameDelay 非標準 読取専用 非推奨;

double で、最後にペイントされたビデオフレームの時刻をを秒単位で返します。

HTMLVideoElement.mozHasAudio 非標準 読取専用 非推奨;

論理値で、動画に音声があるかどうかを示す値を返します。

インスタンスメソッド

親インターフェイスである HTMLMediaElement および HTMLElement から継承したメソッドがあります。

HTMLVideoElement.cancelVideoFrameCallback()

以前に登録された映像フレームコールバック(requestVideoFrameCallback() を参照)を取り消します。

HTMLVideoElement.getVideoPlaybackQuality()

現在の再生指標を含む VideoPlaybackQuality オブジェクトを返します。この情報には、ドロップされたフレーム数や破損したフレーム数、総フレーム数などが含まれます。

HTMLVideoElement.requestPictureInPicture()

ユーザーエージェントが動画をピクチャーインピクチャーモードにすることをリクエストします。

HTMLVideoElement.requestVideoFrameCallback()

新しい映像フレームが合成処理エンジンに送信された際に実行するコールバック関数を登録します。これにより、開発者はそれぞれの映像フレームに対して効率的な操作を行うことができます。

イベント

親である HTMLMediaElement およびその祖先である HTMLElement から継承したイベントがあります。

これらのイベントを待ち受けするには、addEventListener() を使用するか、イベントリスナーをこのインターフェイスの onイベント名 に代入するかしてください。

enterpictureinpicture

ピクチャインピクチャモードになったときに HTMLVideoElement に送信されます。

leavepictureinpicture

ピクチャインピクチャモードになったときに HTMLVideoElement に送信されます。

resize

videoWidthvideoHeight プロパティのうち、どちらか一方または両方が更新された直後に発行されます。

仕様書

Specification
HTML Standard
# htmlvideoelement

ブラウザーの互換性

BCD tables only load in the browser

関連情報