videoObject.controlsプロパティ

videoObject.controlsは、埋め込み動画(video要素)のcontrols属性の値を取得、もしくは、設定するプロパティ。

controls属性には、ドキュメントに埋め込む動画ファイルを制御するユーザーインターフェイス(UI)を表示するかどうかを指定できる。

構文

取得

var $controls = $videoElementReference.controls;

戻り値

video要素のcontrols属性の値。ドキュメントに埋め込んだ動画ファイルを制御するユーザーインターフェイスを表示するかどうか。

  • ユーザーインターフェイスを表示するように設定してあれば、trueを返す。
  • ユーザーインターフェイスを表示するように設定してなければ、falseを返す。

設定

$videoElementReference.controls = boolean;
boolean
ユーザーインターフェイスを表示するかどうかを指定。
  • true:ユーザーインターフェイスを表示する。
  • false:ユーザーインターフェイスを表示しない。

サンプル

ユーザーインターフェイス:

動画ファイル:

video要素のsrc属性の値:

サンプルの動作について

2014/02/01現在、Chromeでのみ動作確認。

  • 「ユーザーインターフェイス:」の右側のラジオボタンで「表示」を選択すると、ユーザーインターフェイスを表示する。「video要素のcontrols属性の値:」の右側に「true」と表示する。
  • 「ユーザーインターフェイス:」の右側のラジオボタンで「非表示」を選択すると、ユーザーインターフェイスを非表示にする。「video要素のcontrols属性の値:」の右側に「false」と表示する。
  • 「1」~「3」のボタンをクリックすると、動画ファイルを切り替える。「video要素のsrc属性の値:」の右横に、再生する動画ファイルのURLを表示する。

サンプルのソースコード

JavaScript

<script type="text/javascript">
function setSrc( $src ) {
    var $elementReference = document.getElementById( "sample" );
    $elementReference.src = $src;
    var $src = $elementReference.src;
    document.getElementById( "sampleOutput" ).innerHTML = $src;
}
function setControls( $controls ) {
    var $elementReference = document.getElementById( "sample" );
    $elementReference.controls = $controls;
    var $controls = $elementReference.controls;
    document.getElementById( "sampleOutputControls" ).innerHTML = $controls;
}
</script>

HTML

<p id="sampleControls">
    ユーザーインターフェイス:
    <label><input type="radio" name="sampleControls" onclick="setControls(true);" checked>表示</label>
    <label><input type="radio" name="sampleControls" onclick="setControls(false);">非表示</label>
</p>
<p id="sampleSrc">
    動画ファイル:
    <button onclick="setSrc('http://alphasis.info/wp-content/uploads/2014/01/javascript-dom-video-sample.mp4');"></button>
    <button onclick="setSrc('http://alphasis.info/wp-content/uploads/2014/01/javascript-dom-video-sample2.mp4');"></button>
    <button onclick="setSrc('http://alphasis.info/wp-content/uploads/2014/01/javascript-dom-video-sample3.mp4');"></button>
</p>
<p>video要素のsrc属性の値:<span id="sampleOutput"></span></p>
<video src="http://alphasis.info/wp-content/uploads/2014/01/javascript-dom-video-sample.mp4" id="sample" controls>
    <p>お使いのブラウザはvideo要素に対応していません。</p>
</video>

スポンサード リンク

カテゴリー: DOM, JavaScript, Videoオブジェクト, リファレンス パーマリンク