HTML
 Computer >> コンピューター >  >> プログラミング >> HTML

HTML DOM Video posterプロパティとは？構文とサンプルコードで解説

HTML DOM の Video poster プロパティは、動画が再生されるまで（またはネットワーク状態が「2（LOADING）」である間）表示されるポスター画像の URL に対応する文字列を、取得および設定できるプロパティです。

video 要素には poster 属性を指定することで、ユーザーが再生ボタンを押す前に表示されるサムネイル画像を設定できます。この属性の値を JavaScript から動的に読み書きするのが、DOM の poster プロパティというわけです。

構文

poster プロパティの基本的な構文は以下の通りです。

文字列値の取得

mediaObject.poster

poster に URL 文字列を設定

mediaObject.poster = URLString

なお、poster が空文字列（''）の場合はポスター画像が設定されていないことを意味し、その際は動画の最初のフレームが代わりに表示されます。

それでは、HTML DOM Video poster プロパティの具体的な使用例を見ていきましょう。

サンプルコード

次の例では、ボタンをクリックすると video 要素にポスター画像が設定されているかどうかを判定し、その結果を画面に表示します。

<!DOCTYPE html>
<html>
<head>
<title>HTML DOM Video poster</title>
<style>
    * {
        padding: 2px;
        margin:5px;
    }
    form {
        width:70%;
        margin: 0 auto;
        text-align: center;
    }
    input[type="button"] {
        border-radius: 10px;
    }
</style>
</head>
<body>
    <form>
        <fieldset>
            <legend>HTML-DOM-Video-poster</legend>
            <video id="demo" width="320" controls><source src="https://www.tutorialspoint.com/html5/foo.mp4" poster='' type="video/mp4"></video><br>
            <input type="button" onclick="getTrackDetails()" value="Get Poster URL">
            <div id="divDisplay"></div>
        </fieldset>
    </form>
    <script>
        var divDisplay = document.getElementById("divDisplay");
        var demo = document.getElementById("demo");
        function getTrackDetails() {
            if(demo.poster === '')
                divDisplay.textContent = 'No Poster, 1st frame of video used as poster';
            else
                divDisplay.textContent = 'Poster URL: '+demo.poster;
        }
    </script>
</body>
</html>

コードのポイント

  • document.getElementById() で video 要素への参照を取得しています。
  • ボタンの onclick イベントで getTrackDetails() 関数を呼び出します。
  • 関数内では demo.poster === '' の比較により、ポスター画像が未設定かどうかを判定し、結果に応じて異なるメッセージを表示します。

実行結果

「Get Poster URL」ボタンをクリックする前 −

HTML DOM Video posterプロパティとは？構文とサンプルコードで解説

ボタンをクリックした後 −

HTML DOM Video posterプロパティとは？構文とサンプルコードで解説

このように、poster プロパティを使えば JavaScript から動的にポスター画像の有無を確認したり、任意の画像 URL を設定したりすることが可能です。動画コンテンツの見栄えを向上させたい場合や、状況に応じてサムネイルを切り替えたい場合に活用してみてください。

  1. HTML DOM Video playbackRateプロパティの使い方！再生速度の取得・設定を解説

    HTML DOMのVideo playbackRateプロパティは、動画メディアの現在の再生速度に対応する数値を取得・設定できるプロパティです。標準の再生速度は「1.0」で、値を大きくすれば早送り、小さくすればスロー再生として動作します。 構文 以下が構文の基本形です。 playbackRateの値を取得する（数値として返す） mediaObject.playbackRate playbackRateに値を設定する mediaObject.playbackRate = number 注意：設定できる数値の最大値は「16」です。また、「0.0」を指定すると動画は静止した状態になります。 Vide

  2. HTML DOMのVideo widthプロパティとは？動画の幅を取得・設定する方法

    HTML DOM の Video width プロパティは、<video> 要素で表示されるメディアの幅（width）に対応する数値を取得・設定できるプロパティです。単位はピクセル（px）で扱われ、JavaScript から動的に動画プレイヤーの横幅を変更したい場合に活用できます。 構文（Syntax） width プロパティの基本的な構文は以下のとおりです。 現在の幅（px）を取得する場合 mediaObject.width 幅（px）を新しく設定する場合 mediaObject.width = number なお、HTML 属性として記述された初期値は <video wi