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>
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>
ユーザーインターフェイス：
<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>