HTMLVideoElement

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

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

プロパティ

_祖先インターフェイスである 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 Non-standard 読取専用 非推奨

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

HTMLVideoElement.mozDecodedFrames Non-standard 読取専用 非推奨

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

HTMLVideoElement.mozPresentedFrames Non-standard 読取専用 非推奨

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

HTMLVideoElement.mozPaintedFrames Non-standard 読取専用 非推奨

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

HTMLVideoElement.mozFrameDelay Non-standard 読取専用 非推奨

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

HTMLVideoElement.mozHasAudio Non-standard 読取専用 非推奨

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

Microsoft 拡張

HTMLVideoElement.msFrameStep() (en-US) Non-standard

動画を 1 フレーム前、または 1 フレーム後にコマ送りします。

HTMLVideoElement.msHorizontalMirror (en-US) Non-standard

画面上で video 要素を水平方向に反転させるかどうかを取得または設定します。

HTMLVideoElement.msInsertVideoEffect() (en-US) Non-standard

指定された動画エフェクトをメディアパイプラインに挿入します。

HTMLVideoElement.msIsLayoutOptimalForPlayback (en-US) Non-standard 読取専用

動画をより効率的にレンダリングできるかどうかを示します。

HTMLVideoElement.msIsStereo3D (en-US) Non-standard 読取専用

読み込まれた動画ソースがステレオ 3D であるとシステムが判断するかどうかを決定します。true に設定されていると、ソースがステレオ 3D であることを示します。

HTMLVideoElement.msZoom (en-US) Non-standard

動画フレームを動画の画面に合わせてトリミングするかどうかを制御します。

メソッド

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

HTMLVideoElement.getVideoPlaybackQuality() (en-US) Experimental

現在の再生メトリクスを含む 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
# htmlvideoelement

ブラウザーの互換性

BCD tables only load in the browser

関連情報