HTMLInputElement: checked property
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.
The checked
property of the HTMLInputElement
interface specifies the current checkedness of the element; that is, whether the form control is checked or not.
The boolean checked
property is relevant to the radio
(<input type="radio">
) and checkbox
(<input type="checkbox">
) input types.
The presence of the HTML checked
attribute indicates the checkbox is checked by default. It does not indicate whether this checkbox is currently checked: if the checkbox's state is changed, this content attribute does not reflect the change; only the HTMLInputElement
's checked
IDL property is updated. The checked
attribute is reflected by the defaultChecked
property.
When a radio input checked
property is true
, all other radio inputs with the same name
are false
. If any radio button in a same-named group of radio buttons is required
, as long as one button in the group is checked
, the ValidityState
object's read-only valueMissing
property for each radio button in the group will be false
.
A checkbox's value is only included in the submitted data upon form submission if checked
is true. The value of the HTMLInputElement.indeterminate
property has no effect on a checkbox's checked
value.
Value
A boolean.
Examples
const inputElement = document.getElementById("contactMail");
console.log(inputElement.checked);
inputElement.checked = true;
Specifications
Specification |
---|
HTML Standard # dom-input-checked |
Browser compatibility
BCD tables only load in the browser
See also
<input>
HTMLInputElement.validity
:checked
pseudo-class