The RbCbRendererBase class is the abstract base class for com.sun.rave.web.ui.renderer.RadioButtonRenderer and com.sun.rave.web.ui.renderer.CheckboxRenderer .

RbCbRendererBase provides encoding functionality for the RadioButtonRenderer and CheckboxRenderer. This includes an implementation of getConvertedValue, and a method called renderSelection which a subclass calls to render either a Checkbox or a RadioButton component at the appropriate time.
The renderer subclass must implement

• isSelected in order for this class to generically render either component
• getStyle so the specific subclass can specify the appropriate ThemeStyle constants.

Decoding

See com.sun.rave.web.ui.renderer.RadioButtonRenderer and com.sun.rave.web.ui.renderer.CheckboxRenderer for details on decoding requests.

Encoding

The renderer emits the following HTML elements.

• An INPUT element of type specified by the subclass in renderSelection
• An optional com.sun.rave.web.ui.component.ImageComponent component is rendered for each INPUT element
• An optional com.sun.rave.web.ui.component.Label component is rendered for each INPUT element

The ID attributes for HTML elements are constructed as follows, where <cid> is the clientId of the component being rendered.

Encoding the INPUT element

If the name property of the component is null the name attribute of the INPUT element will be set to the value of the component's clientId and the control will not be part of a group, and behave as an individual control.
If the name property is not null then its value is used as the value of the name attribute of the HTML INPUT element and the control will behave as part of a group.

The ConversionUtilities.getValueAsString method is called with the value of the component's selectedValue property and the result is used as the value of the HTML INPUT element's value attribute. The String value that is returned may be the actual value of the selectedValue property or the result of a conversion of a developer defined object value to a String or "true" if the selectedValue property was null or never assigned a value.The components com.sun.rave.web.ui.component.RadioButton and com.sun.rave.web.ui.component.Checkbox implement the behavior of returning "true" when selectedValue is null. Therefore if the component parameter is not one of these classes then this behavior may vary.

If isSelected returns true the the value of the HTML INPUT element's checked attribute is set to "checked", otherwise the checked attribute is not rendered.

The following component properties are obtained and rendered in turn and equivalent to the HTML INPUT element's attributes of the same name, but rendered in all lowercase.

• disabled
• readOnly
• tabIndex
• style
The component's toolTip property if not null is rendered as the value of the HTML INPUT element's title attribute.
The HTML INPUT element's class attribute is set to the component's styleClass property appended with the value returned from a call to the getStyle method.

Rendering the image component

The renderer calls the component's getImageComponent method to obtain an instance of a com.sun.rave.web.ui.component.ImageComponent component. If null is returned, no image will appear with the control. If a non null instance is returned, the appropriate disabled or enabled style class returned by getStyle is appended to the image's styleClass property. RenderingUtilities.renderComponent is called to render the component.


If an image is rendered it appears to the immediate left of the control.

Encoding the label component

The renderer calls the component's getLabelComponent method to obtain an instance of a com.sun.rave.web.ui.component.Label component. If null is returned, no label will appear with the control. If a non null instance is returned, the appropriate disabled or enabled style class returned by getStyle is appended to the label's styleClass property. RenderingUtilities.renderComponent is called to render the component.

Attempt to convert previously stored state information into an object of the type required for this component (optionally using the registered javax.faces.convert.Converter for this component, if there is one).

The list of attribute names for Rb and Cb

Attempt to convert previously stored state information into an object of the type required for this component (optionally using the registered javax.faces.convert.Converter for this component, if there is one). If conversion is successful, the new value is returned and if not, a javax.faces.convert.ConverterException is thrown.