CHECKED Attribute | checked

HTML (DHTML)

CHECKED Attribute | checked Property

Internet Development Index

Sets or retrieves the state of the check box or radio button.

Syntax

HTML<ELEMENT CHECKED ... >
Scriptingobject.checked [ = bChecked ]

Possible Values

bCheckedBoolean that specifies or receives one of the following values.
falseDefault. Control is not selected.
trueControl 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)
{
alert("It's got a check; now off to Microsoft!");
window.open("http://www.microsoft.com");
}
}
</SCRIPT>
</HEAD>
<BODY>
Check here if you wish to go to Microsoft:
<INPUT ID=oCheckbox TYPE=checkbox onclick=checkthis()>
</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 Non-Microsoft link and is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 Non-Microsoft link.

Applies To

INPUT type=checkbox, INPUT type=radio

See Also

defaultChecked, Introduction to Forms