DOM Objects
DOM Anchor
DOM Applet
DOM Area
DOM Base
DOM Basefont
DOM Body
DOM Button
DOM Checkbox
DOM Document
DOM Event
DOM FileUpload
DOM Form
DOM Frame
DOM Frameset
DOM Hidden
DOM History
DOM Iframe
DOM Image
DOM Link
DOM Location
DOM Meta
DOM Navigator
DOM Option
DOM Password
DOM Radio
DOM Reset
DOM Screen
DOM Select
DOM Style
DOM Submit
DOM Table
DOM TableData
DOM TableHeader
DOM TableRow
DOM Text
DOM Textarea
DOM Window

Radio Object

For each instance of an HTML <input type="radio"> tag on a form, a Radio object is created.

All Radio objects are stored in the elements array of the corresponding form. You can access a Radio object by indexing this array - either by number (0 represents the first element in a form) or by using the value of the name attribute.

The Radio object's properties, methods, and events are described below:

N: Netscape (including Mozilla when N6 or higher), IE: Internet Explorer, W3C: World Wide Web Consortium (Internet Standard)

Properties

Syntax: object.property_name

Property Description N IE  W3C
accept Sets or returns a list of content types that the server that processes this form will handle correct   - Yes
accesskey Sets or returns the keyboard key to access the radio button   4 Yes
align Sets or returns the alignment of the radio button according to the surrounding text   - Yes
alt Sets or returns an alternate text to display if the browser does not support radio buttons   - Yes
checked Sets or returns the current state of the radio button (true if selected and false if not selected) 2 3.02 Yes
defaultChecked Sets or returns the default value of the checked attribute (true if checked by default and false if not) 2 3.02 Yes
disabled Sets or returns whether or not the radio button should be disabled   5.5 Yes
form Returns a reference to the radio button's parent form 2 3.02 Yes
id Sets or returns the id of the radio button (In IE 4 this property is read-only)   4 No
name Sets or returns the name of the radio button 2 3.02 Yes
size Sets or returns the size of the radio button   3.02 Yes
tabIndex Sets or returns the tab order for the radio button   4 Yes
type The type of the form element. For a radio object it will always be "radio" 3 3.02 Yes
value Sets or returns the value of the value attribute of the radio button 2 3.02 Yes

Methods

Syntax: object.method_name()

Method Description N IE W3C
blur() Removes focus from the radio button 2 4 Yes
click() Simulates a mouse-click on the radio button   4 Yes
focus() Sets focus on the radio button 2 3.02 Yes
select() Selects the radio button 2 4 No

Events

Syntax: object.event_name="someJavaScriptCode"

Event Description N IE W3C
onBlur Executes some code when the radio button loses focus 2 4  
onClick Executes some code when the user clicks on the radio button   4  
onFocus Executes some code when the radio button gets focus 2 3.02  
onSelectStart Executes some code when the radio button is selected   4