INPUT TYPE=radio XHTML Element
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 for All DOM 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
Attribute | Value | PPC | SP | Description |
---|---|---|---|---|
ACCESSKEY | 0...9, #, * | Yes | Yes | Gives access or focus to an active HTML element by using a keypad number.
Note For Pocket PCs, supported only for devices running Windows Mobile 2003 software or later |
CHECKED | Yes | Yes | Specifies selection of the radio control. | |
CLASS | Yes | Yes | Associates the element with a CSS style.
Note Supported only for devices running Windows Mobile 2003 software or later. |
|
DISABLED | Yes | Yes | 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 | Yes | Yes | Uniquely identifies the element within a document.
Note Supported only for devices running Windows Mobile 2003 software or later. |
|
NAME | String | Yes | Yes | Specifies the radio control name. |
ONBLUR | Yes | Yes | Event that occurs when the radio control loses focus by the pointing device or by tabbing navigation.
Note Supported only for devices running PocketPC 2002 and Smartphone 2002 software or later. |
|
ONCLICK | Yes | Yes | Event that occurs when the user chooses the radio control.
Note Supported only for devices running PocketPC 2002 and Smartphone 2002 software or later. |
|
ONFOCUS | Yes | Yes | Event that occurs when the radio control receives focus by a pointing device or by tabbing navigation.
Note Supported only for devices running PocketPC 2002 and Smartphone 2002 software or later. |
|
STYLE | Yes | Yes | Provides the definition of the CSS styles used for this element.
Note Supported only for devices running Windows Mobile 2003 software or later. |
|
TABINDEX | Yes | Yes | Sets the order in which elements are tabbed to.
Note Supported only for devices running Windows Mobile 2003 software or later. |
|
VALUE | String | Yes | Yes | Specifies the radio control value. |
Scripting Properties
Property | Type | Access | Comments |
---|---|---|---|
accessKey | string | Read/Write | |
checked | boolean | Read/Write | Sets or retrieves the state of the input type=radio control. The only possible values are true and false. |
disabled | boolean | Read/Write | |
defaultChecked | boolean | Read/Write | Specifies whether or not the input type=radio is checked by default. |
form | object | Read Only | |
name | string | Read Only | |
type | string | Read Only | Always returns: radio |
value | string | Read/Write | Sets or retrieves that value of the input type=radio control. The default value is "on". |
Scripting Events
Event | Supported | Comment |
---|---|---|
onclick | Yes | This event fires when the user taps on the radio button element. Note the event only fires if the user does a pen down while on the radio button and a pen up over the same radio. The author can specify special handler for this event. |
onblur | Yes | |
onfocus | Yes |
Scripting Methods
Method | Support | Comments |
---|---|---|
click | Yes | Syntax:
|
focus | Yes | Syntax:
|
Requirements
Pocket PC: Windows Mobile 5.0 and later
Smartphone: Windows Mobile 5.0 and later
OS Versions: Windows CE 5.01 and later
See Also
Send Feedback on this topic to the authors