Sets or retrieves the state of the check box or radio button.
Syntax
| HTML | <ELEMENT CHECKED
... >
|
|---|
| Scripting | [ bChecked = ] object.checked |
|---|
Possible Values
| bChecked | Boolean that
specifies or receives one of the following values.| false | Default. Control is not selected. | true | Control is selected. |
|
The property is read/write.
The property has a default value of
false.
Remarks
Check boxes that are not selected do not return their values when the form is submitted.
A user can select a radio button only if the button has a name. To clear a selected radio button, a user must select another button in the set.
Example
This example retrieves the checked property to fire an event.
<head>
<script>
function checkthis()
{
if (oCheckbox.checked == true)
{
window.open("http://www.microsoft.com");
}
}
</script>
</head>
<body>
<p>Check here if you wish to go to Microsoft:
<input id="oCheckbox" type="checkbox" ></p>
</body>
This feature requires Microsoft® Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.
Standards Information
This property is defined in
HTML 3.2 
and
is defined in
World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 .
Applies To
See Also
defaultChecked, Introduction to Forms