audioObject.controlsプロパティ

audioObject.controlsは、埋め込みオーディオ(audio要素)のcontrols属性の値を取得、もしくは、設定するプロパティ。

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

構文

取得

var $controls = $audioElementReference.controls;

戻り値

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

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

設定

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

サンプル

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

オーディオファイル:

audio要素のcontrols属性の値:

audio要素のsrc属性の値:

サンプルの動作について

  • 「ユーザーインターフェイス:」の右側のラジオボタンで「表示」を選択すると、ユーザーインターフェイスを表示する。「audio要素のcontrols属性の値:」の右側に「true」と表示する。
  • 「ユーザーインターフェイス:」の右側のラジオボタンで「非表示」を選択すると、ユーザーインターフェイスを非表示にする。「audio要素のcontrols属性の値:」の右側に「false」と表示する。
  • 「テクノ系サウンド」のボタンをクリックすると、アルペジオ、ビート、ベースラインを含んだオーディオファイルに切り替える。「audio要素のsrc属性の値:」の右横に、再生するオーディオファイルのURLを表示する。
  • 「アルペジオ」のボタンをクリックすると、アルペジだけのオーディオファイルに切り替える。「audio要素のsrc属性の値:」の右横に、再生するオーディオファイルのURLを表示する。
  • 「ビートとベースライン」のボタンをクリックすると、ビートとベースラインのオーディオファイルに切り替える。「audio要素のsrc属性の値:」の右横に、再生するオーディオファイルのURLを表示する。

サンプルのソースコード

JavaScript

<script type="text/javascript">
function setSrc( $src ) {
    var $elementReference = document.getElementById( "sample" );
    $elementReference.src = $src;
    $elementReference.autoplay = true;
    var $src = $elementReference.src;
    document.getElementById( "sampleOutputSrc" ).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">
    オーディオファイル:
    <label><input type="radio" name="sampleSrc" onclick="setSrc('http://alphasis.info/wp-content/uploads/2011/05/lmms-tutorial-techno-arpeggio.mp3');" checked>テクノ系サウンド</label>
    <label><input type="radio" name="sampleSrc" onclick="setSrc('http://alphasis.info/wp-content/uploads/2011/05/lmms-tutorial-techno-arpeggio-2-only.mp3');">アルペジオ</label>
    <label><input type="radio" name="sampleSrc" onclick="setSrc('http://alphasis.info/wp-content/uploads/2011/05/lmms-tutorial-techno-bass.mp3');">ビートとベースライン</label>
</p>
<p>audio要素のcontrols属性の値:<span id="sampleOutputControls"></span></p>
<p>audio要素のsrc属性の値:<span id="sampleOutputSrc"></span></p>
<audio src="http://alphasis.info/wp-content/uploads/2011/05/lmms-tutorial-techno-arpeggio.mp3" id="sample" controls>
    <p>お使いのブラウザはaudio要素に対応していません。</p>
</audio>

スポンサード リンク

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