HTMLVideoElement: videoHeight プロパティ

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.

HTMLVideoElement インターフェイスの videoHeight プロパティは読み取り専用で、動画の内在的な高さを CSS ピクセル単位で示します。 単純に言えば、これはメディアの自然なサイズでの高さです。

動画の内在的な高さを CSS のピクセル数で示す整数値。 要素の readyStateHTMLMediaElement.HAVE_NOTHING の場合、このプロパティの値は 0 です。これは、動画やポスターのフレームサイズ情報がまだ利用できないためです。

内在的な幅と高さについて

ユーザーエージェントは、この要素のメディアの内在的な幅と高さを、このメディアの幅と高さの生のピクセル数から計算し始め、以下のような要素を考慮します。

  • このメディアのアスペクト比
  • メディアのクリーンアパーチャ(対象とする縦横比に一致する、メディアを中心とした長方形)。
  • 対象とする機器の解像度。
  • そのメディア形式が要求する他の要素。

要素がレンダリング動画ではなくポスターフレームを表示している場合、ポスターフレームの内在サイズが <video> 要素のサイズとみなされます。

メディアの内在サイズが変更された時点で、要素の readyStateHAVE_NOTHING でない場合、resize イベントが <video> 要素に送られます。 これは、要素がポスターフレームの表示から動画コンテンツの表示に切り替わるときや、表示される動画トラックが変わるときに発生します。

この例では、resize イベントのハンドラーを作成し、<video> 要素のサイズをそのコンテンツの内在サイズに一致するように変更します。

js
let v = document.getElementById("myVideo");

v.addEventListener(
  "resize",
  (ev) => {
    let w = v.videoWidth;
    let h = v.videoHeight;

    if (w && h) {
      v.style.width = w;
      v.style.height = h;
    }
  },
  false,
);

これは videoWidthvideoHeight の両方が 0 でない場合にのみ変更を適用することに注意してください。 これにより、寸法についてまだ利用できる真の情報がない場合に、無意味な変更が適用されるのを避けることができます。

仕様書

Specification
HTML Standard
# dom-video-videoheight-dev

ブラウザーの互換性

BCD tables only load in the browser