Java Doc for RadioButtonRenderer.java in  » IDE-Netbeans » visualweb.api.designer » com » sun » rave » web » ui » renderer » Java Source Code / Java DocumentationJava Source Code and Java Documentation

The RadioButtonRenderer renders a com.sun.rave.web.ui.component.RadioButton component.

Encoding

The RadioButtonRenderer renders a RadioButton as:

• An INPUT element of type radio for each radio button.
• An optional image. The component rendered for this feature is obtained from a call to getImageComponent() on the component being rendered.
• An optional label. The component rendered for this feature is obtained from a call to getLabelComponent() on the component being rendered.

The CSS selectors for the elements and components that comprise a radio button are identified by java constants defined in the ThemeStyles class.

• RADIOBUTTON for the INPUT element
• RADIOBUTTON_DISABLED for the INPUT element of a disabled radio button
• RADIOBUTTON_LABEL for label component if a label is rendered
• RADIOBUTTON_LABEL_DISABLED for a label component of a disabled radio button, if a label is rendered
• RADIOBUTTON_IMAGE for an image component if an image is rendered
• RADIOBUTTON_IMAGE_DISABLED for an image component of a disabled radio button if an image is rendered.

For more details on the encoding the RadioButton component see the super class com.sun.rave.web.ui.renderer.RbCbRendererBase

Decoding

If the INPUT element representing a radio button is selected on the the client, the submitted request will contain a request parameter whose name is the value of the name attribute of the selected HTML INPUT element. The value of the request parameter will be the value of the value attribute of the selected HTML INPUT element.

The component being decoded is selected if the component's isDisabled and isReadOnly methods return false and:

• a request parameter exists that is equal to its name property. If the name property is null, then a request parameter exists that is equal to its clientId property.

And

• the request parameter's value is String.equal to the the component's selectedValue property, after conversion to a String, by calling ConversionUtilities.convertValueToString. If the component was encoded as a boolean control, then the request parameter's value must be equal to the component's clientId property.

If selected, a String[1] array is assigned as the component's submitted value where the single array element is the String version of the selectedValue property or "true" if the component was encoded as a boolean control.
If not selected, a String[0] array is assigned as the component's submitted value or a String[1] array where the single array element is "false" if the component was encoded as a boolean control.

If the component's isDisabled or isReadOnly methods return true no submitted value is assigned to the component, and results in a null submitted value implying the component was not submitted, and the state of the component is unchanged.

Since the RadioButtonRenderer only renders a single RadioButton component it cannot enforce that at least one radio button should be selected among a group of RadioButton components with the same name property.

If the RadioButton is selected, the selected property will be the same value as the selectedValue property. If more than one RadioButton component is encoded with the same name property and more than one RadioButton's is selectred, the last selected RadioButton component that is encoded will be appear as checked in the HTML page. Subsequently during the next submit, only the checked RadioButton component will be selected.

Decode the RadioButton selection.

If the value of the component's name property has been set, the value is used to match a request parameter. If it has not been set the component clientId is used to match a request parameter.

Decode the RadioButton selection.

If the value of the component's name property has been set, the value is used to match a request parameter. If it has not been set the component clientId is used to match a request parameter. If a match is found, and the value of the of the request parameter matches the String value of the component's selectedValue property, the radio button is selected. The component's submitted value is assigned a String[1] array where the single array element is the matching parameter value.

If no matching request parameter or value is found, an instance of String[0] is assigned as the submitted value, meaning that this is a component was not selected.

If the component was encoded as a boolean control the value of the matching request attribute will be the component's clientId property if selected. If selected the submitted value is new String[] { "true" } and new String[] { "false" } if not selected.

It is the developer's responsibility to ensure the validity of the name property (the name attribute on the INPUT element) by ensuring that it is unique to the radio buttons for a given group within a form.