HTMLInputElement: checked プロパティ
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
checked
は HTMLInputElement
インターフェイスのプロパティで、要素の現在のチェック状態、つまり、あるフォームコントロールがチェック済みかどうかを指定します。
論理プロパティである checked
は、 radio
(<input type="radio">
) および checkbox
(<input type="checkbox">
) 入力型に関連します。
HTML の checked
属性が存在することは、チェックボックスが既定でチェックされていることを示します。ただし、そのチェックボックスが現在チェックされているかどうかは示しません。チェックボックスの状態が変更された場合、このコンテンツ属性は変更を反映しません。HTMLInputElement
の checked
IDL プロパティのみが更新されます。checked
属性は、 defaultChecked
プロパティによって反映されます。
ラジオ入力の checked
プロパティが true
の場合、同じ name
を持つ他のラジオ入力はすべて false
です。同じ名前を持つラジオボタングループ内のいずれかのラジオボタンが required
の場合、グループ内のボタンが 1 つでもチェックされると、グループ内の各ラジオボタンに対する ValidityState
オブジェクトの読み取り専用の valueMissing
プロパティは false
になります。
チェックボックスの値はフォームを送信する際に送信データに含まれます。チェックボックスの checked
値に影響を与えるものとして、 HTMLInputElement.indeterminate
プロパティの値があります。
値
論理値です。
例
const inputElement = document.getElementById("contactMail");
console.log(inputElement.checked);
inputElement.checked = true;
仕様書
Specification |
---|
HTML Standard # dom-input-checked |
ブラウザーの互換性
BCD tables only load in the browser