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>
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');">1</button>
<button onclick="setSrc('http://alphasis.info/wp-content/uploads/2014/01/javascript-dom-video-sample2.mp4');">2</button>
<button onclick="setSrc('http://alphasis.info/wp-content/uploads/2014/01/javascript-dom-video-sample3.mp4');">3</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>
ユーザーインターフェイス:
<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');">1</button>
<button onclick="setSrc('http://alphasis.info/wp-content/uploads/2014/01/javascript-dom-video-sample2.mp4');">2</button>
<button onclick="setSrc('http://alphasis.info/wp-content/uploads/2014/01/javascript-dom-video-sample3.mp4');">3</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>