INPUT TYPE=radio XHTML Element

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The INPUT TYPE=radio element creates a radio button control. This is an inline element and does not require a closing tag.

Use a radio button control to limit a user's selection to a single value within a set of values. To do this, you must group each button in a set of radio buttons by assigning each button the same name. When a user submits a form, a selected radio button generates a name or value pair in the form data only if the button has a value.

Note

If a radio button is in a group and the button has no value, the button name is submitted without a value.

Using this Element

There are some common properties and collections that apply to all the elements of the document object model, see Common Properties, Methods and Collections for the HTML Elements in Internet Explorer Mobile.

This element can be used within a web page with attributes.

This element can be used within scripts where it will have properties, events and methods.

Attributes

The following table shows items that Internet Explorer Mobile supports.

Attribute	Value	Description
ACCESSKEY	0…9, #, *	Gives access or focus to an active HTML element by using a keypad number. > [!NOTE] > For Pocket PC for Windows Mobile 2003 Second Edition or later
CHECKED		Specifies selection of the radio control.
CLASS		Associates the element with a CSS style. > [!NOTE] > Supported only for devices running Windows Mobile 2003 software or later.
DISABLED		Disables the element so that it appears dimmed and does not respond to user input. > [!NOTE] > Supported only for devices running Windows Mobile 2003 software or later.
ID		Uniquely identifies the element within a document. > [!NOTE] > Supported only for devices running Windows Mobile 2003 software or later.
NAME	String	Specifies the radio control name.
ONBLUR		Event that occurs when the radio control loses focus by the pointing device or by tabbing navigation. > [!NOTE] > Supported only for devices running Pocket PC 2002 and Smartphone 2002 software or later.
ONCLICK		Event that occurs when the user chooses the radio control. > [!NOTE] > Supported only for devices running Pocket PC 2002 and Smartphone 2002 software or later.
ONFOCUS		Event that occurs when the radio control receives focus by a pointing device or by tabbing navigation. > [!NOTE] > Supported only for devices running Pocket PC 2002 and Smartphone 2002 software or later.
STYLE		Provides the definition of the CSS styles used for this element. > [!NOTE] > Supported only for devices running Windows Mobile 2003 software or later.
TABINDEX		Sets the order in which elements are tabbed to. > [!NOTE] > Supported only for devices running Windows Mobile 2003 software or later.
VALUE	String	Specifies the radio control value.

Scripting Properties

The following table shows items that Internet Explorer Mobile supports.

Property	Type	Access	Comments
accessKey	string	Read/Write	Sets or retrieves the number associated with the accesskey attribute. > [!NOTE] > Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.
checked	boolean	Read/Write	Sets or retrieves the state of the input type=radio control. The only possible values are True or False.
disabled	boolean	Read/Write	Sets or retrieves the value that indicates whether the user can interact with the object. > [!NOTE] > Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.
defaultChecked	boolean	Read/Write	Specifies whether or not the input type=radio control is checked by default.
form	object	Read	Retrieves a reference to the form that the object is embedded in. > [!NOTE] > Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.
indeterminate		Read/Write	Sets or retrieves whether the user has changed the status of a radio control. > [!NOTE] > Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.
name	string	Read	Sets or retrieves the name of the input type=radio control. > [!NOTE] > Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.
offsetHeight	Number	Read-only	Contains the height of the object in pixels, relative to the parent element.
offsetLeft	Number	Read-only	Contains the number of pixels from the left of the parent element.
offsetParent	String	Read-only	Contains a reference to the container object that defines the offsetTop and offsetLeft properties of the object.
offsetTop	Number	Read-only	Contains the number of pixels from the top of the parent element
offsetWidth	Number	Read-only	Contains the width of the object in pixels, relative to the parent element.
type	string	Read	Always returns — radio.
value	string	Read/Write	Sets or retrieves value of the input type=radio control. The default value is "on".

Scripting Events

The following table shows items that Internet Explorer Mobile supports.

Event	Comment
onblur	Occurs when an element loses focus either by the pointing device or by keypad navigation. > [!NOTE] > Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.
onclick	Occurs when the user selects the radio button element and only when the user presses the pen down on then lifts up the pen over the same radio button. You can specify a special handler for this event.
onfocus	Occurs when an element receives focus either by the pointing device or by tabbing navigation. > [!NOTE] > Supported only for devices running Smartphone 2002 and Pocket PC 2002 software or later.

Scripting Methods

The following table shows items that Internet Explorer Mobile supports.

Method	Arguments	Comments
blur		Syntax: radio.blur()
click		Syntax: radio.click() Simulates clicking on the radio button causing the onclick event to fire.
focus		Syntax: radio.focus() Sets focus to the radio button control.
getAttribute	option	Syntax: vAttrValue=radio.getAttribute(sAttrName[,iFlags]) Returns the value of the specified attribute. If the attribute is not present then a NULL is returned. sAttrName is a String containing the name of the attribute. iFlags is an integer that specifies one or more of the following: 0 (Default) Performs a property search that is not case-sensitive, and returns an interpolated value if the property is found. 1 Performs a case-sensitive property search. To find a match, the uppercase and lowercase letters in sAttrName must exactly match those in the attribute name. 2 Returns the value exactly as it was set in script or in the source document.

Requirements

Windows Mobile

Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Concepts

Internet Explorer Mobile HTML Elements