このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
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 2015年7月.
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 プロパティの値があります。
In this article
値
論理値です。
例
const inputElement = document.getElementById("contactMail");console.log(inputElement.checked);inputElement.checked = true;仕様書
| Specification |
|---|
| HTML> # dom-input-checked> |