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 プロパティの値があります。

値

論理値です。

例

js
const inputElement = document.getElementById("contactMail");
console.log(inputElement.checked);
inputElement.checked = true;

仕様書

Specification
HTML
# dom-input-checked

ブラウザーの互換性

BCD tables only load in the browser

関連情報