ビデオ poster 属性

HTML DOM Video オブジェクト

定義と使用法

poster 属性は、ビデオの poster 属性の値を設定または返します。

poster ビデオをダウンロードする際やユーザーが再生ボタンをクリックする前に表示する画像を指定します。設定されていない場合、ビデオの最初のフレームが使用されます。

例

例 1

ビデオのカバー画像を変更：

document.getElementById("myVideo").poster = "/images/w3logo.png";

自分で試してみる

例 1

カバー画像の URL を取得：

var x = document.getElementById("myVideo").poster;

自分で試してみる

文法

poster 属性を返します：

videoObject.poster

poster 属性の設定：

videoObject.poster = URL

属性値

値 説明
URL

画像ファイルの URL を指定します。

可能な値：

  • 絶対 URL - 別のウェブサイトへのリンク（例えば href="http://www.example.com/poster.jpg"）
  • 相対 URL - サイト内のファイルへのリンク（例えば href="poster.jpg"）

技術的詳細

返り値： 文字列値、カバー画像の URL を表す。プロトコル（例えば http://）を含む完全な URL を返します。

ブラウザのサポート

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
サポート 9.0 サポート サポート サポート

関連ページ

HTML 参考マニュアル：HTML <video> poster 属性

HTML DOM Video オブジェクト