inputCheckboxObject.checkedプロパティ

inputCheckboxObject.checkedは、チェックボックス(type属性がcheckboxであるinput要素)のchecked属性の値を取得、もしくは、設定するプロパティ。

checked属性には、チェックボックスを選択(チェック)するかどうかを指定することができる。

構文

取得

var $checked = $inputElementReference.checked;

戻り値

チェックボックスのchecked属性値。

  • チェックボックスが選択されていれば「true」を返す。
  • チェックボックスが選択されていなければ「false」を返す。

設定

$inputElementReference.checked = boolean;
boolean
選択するかどうかを指定。
  • true:選択する。
  • false:選択しない。

サンプル

サンプルの動作について

  • 「チェックボックスAを選択する」ボタンをクリックすると、「チェックボックスA」にチェックを入れる。
  • 「チェックボックスAを選択しない」ボタンをクリックすると、「チェックボックスA」のチェックを外す。
  • 「チェックボックスBは選択されているか」ボタンをクリックすると、
    • 「チェックボックスB」がチェックされていれば、ボタンの右横に「true」と表示する。
    • 「チェックボックスB」がチェックされていなければ、ボタンの右横に「false」と表示する。

サンプルのソースコード

JavaScript

<script type="text/javascript">
function setType( $checked ) {
    var $elementReference = document.getElementById( "sampleA" );
    $elementReference.checked = $checked;
}
function getType() {
    var $elementReference = document.getElementById( "sampleB" );
    var $checked = $elementReference.checked;
    document.getElementById( "sampleOutput" ).innerHTML = $checked;
}
</script>

HTML

<div id="sampleWarp">
    <p>
        <button onclick="setType( true );">チェックボックスAを選択する</button>
        <button onclick="setType( false );">チェックボックスAを選択しない</button>
    </p>
    <p>
        <button onclick="getType();">チェックボックスBは選択されているか</button>
        <span id="sampleOutput"></span>
    </p>
    <p>
        <label><input type="checkbox" name="sampleCheckbox" id="sampleA" value="A"> チェックボックスA</label>
        <label><input type="checkbox" name="sampleCheckbox" id="sampleB" value="B"> チェックボックスB</label>
    </p>
</div>

スポンサード リンク

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