DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

RADIO

Creates a radio button.

Radio buttons are on/ off switches that may be toggled by the user. A switch is "on" when the control element's checked attribute is set. When a form is submitted, only "on" radio button controls can become successful.

Several radio buttons in a form may share the same control name. Thus, for example, radio buttons allow users to select several values for the same property.

Radio buttons are like checkboxes except that when several share the same control name, they are mutually exclusive: when one is switched "on", all others with the same name are switched "off".

Radio buttons are normally grouped in a FIELDSET object.

Note from W3C for user agent behaviour: If no radio button in a set sharing the same control name is initially "on", user agent behavior for choosing which control is initially "on" is undefined.

Note: Since existing implementations handle this case differently, the current specification differs from RFC 1866 ([RFC1866] section 8.1.2.4), which states:

At all times, exactly one of the radio buttons in a set is checked. If none of the elements of a set of radio buttons specifies `checked', then the user agent must check the first radio button of the set initially.

Since user agent behavior differs, authors should ensure that in each set of radio buttons that one is initially "on".

accesskey

Description:
See general information for accesskey.

alt

Description:
See general information for alt.

checked

Description:
See general information for checked.

class

Description:
See general information for class.

dir

Description:
See general information for dir.

disabled

Description:
See general information for disabled.

id

Description:
See general information for id.

label

Description:
See general information for label.

lang

Description:
See general information for lang.

layout

Description:
See general information for Layout and the radio specific information.

name

Description:
See general information for name.

style

Description:
See general information for style.

tabindex

Description:
See general information for tabindex.

title

Description:
See general information for title.

type

Description:
See general information for type.
Default:
radio

value

Description:
See general information for value.

[tsref:(cObject).FORM.FormObject.RADIO]