|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjavax.faces.component.UIComponent
javax.faces.component.UIComponentBase
javax.faces.component.UIOutput
javax.faces.component.UIInput
com.sun.webui.jsf.component.WebuiInput
com.sun.webui.jsf.component.Selector
com.sun.webui.jsf.component.RbCbSelector
com.sun.webui.jsf.component.RadioButton
public class RadioButton
A component that represents a radio button.
The RadioButton can be used as a single radio button
or one radio button among a group of radio button. A group
of radio button represents a multiple selection list which can have any
number of radio button selected, or none selected. A radio button can
represent a Boolean value, a String value,
or a developer defined Object value.
The RadioButton uses both the selected
and selectedValue properties to pass information about
the radio button's selection status. The selected
property is used to indicate that the radio button is selected.
The selectedValue property is used to pass a data value,
a string by default, for the radio button. A radio button is considered to be
selected when the value of the selected property is equal
to the value of the selectedValue property. A radio button can
be initally selected by assigning the same value
to the selectedValue and the selected
properties. isChecked is called to determine
if this RadioButton is selected.
If the selectedValue property is not specified or its
value is null then the radio button behaves like a
boolean control. If the radio button is selected, the value of the
selected property is a true Boolean
instance. If the radio button is not selected, the value of the
selected property will be a false Boolean
instance.
Note that a value binding expression that evaluates to a
primitive boolean value can be assigned to the selected
property. Proper type coercion from Boolean to
boolean occurs.
When a radio button is part of a group, the selected radio
button is maintained as a request attribute in the
RequestMap. The name of the attribute is
the value of the radio button's name property.
The request attribute value is the
value of the selectedValue property of the
selected radio button.
The selected property
of the selected radio button within the group, will also contain the
value of the selectedValue property of the
respective selected radio button. If no radio buttons are selected,
no request attribute is created, however at least one radio button
must be selected.
Note that the RadioButton does not enforce the
requirement that at least one radio button must be selected.
The application should ensure that this requirement is met.
radio button tag as a boolean control
If the selectedValue property is not specified or its
value is null then the radio button behaves like a
boolean control.
To use the RadioButton as a boolean control, do not
specify a value for the selectedValue property. The
radio button is selected if the selected property is not
null and has the value of a Boolean instance with a true
value. If the radio button is not selected, then the value of the
selected property is a false Boolean instance.
Note that using a boolean radio button in a group and
referencing the request property for the selected radio button is not
useful, since the value of the request property will be an
indistinguishable true value.
RadioButton to represent a developer defined
value The selectedValue property can be assigned a
developer defined object value to represent the value of a selected
radio button. If the radio button is selected, the value of the
selected property is assigned the value of the
selectedValue property.
If the value of the selectedValue property is a
developer defined object, a Converter must be registered
to convert to and from a String value.
In addition the object must support an
equals method that returns true when the
value of the selectedValue property is compared to
the selected property value in order to detect a
selected radio button.
RadioButton as one control in a group
The name property determines whether a
radio button is part of a group. A radio button is treated as part of a group
of radio buttons if the name property of the radio button is
assigned a value equal to the name property of the other
radio buttons in the group. In other words, all radio button of a
group have the same name property value. The group behaves
like a single selection list, where only one radio button
can be selected. The value of the name property must
be unique within the scope of the Form parent containing the
radio buttons.
The following facets are supported:
ImageComponent subcompoent
normally created for the image associated with the radio button,
if the imageURL property is not null.Label subcomponent normally
created for the label associated with the radio button, if the
label property is not null.
Add an image or label facet to the RadioButton if more
control over the properties of the subcomponents is needed.
Note that if a facet is exists, RadioButton properties
that would normally be assigned to the created subcomponent, will
not be assigned to the facet
Note that unexpected layout of the RadioButton may occur
if the component specified by the facet is not a
ImageComponent for the image facet or
Label for the label facet.
An image and a label may be associated with the
RadioButton.
If the imageURL property is not null and an image facet
does not exist then a ImageComponent
component is created.
If the label property is not null and a label facet does not
exist then a Label component is
created.
The following RadioButton properties are assigned to
the subcomponents only if a facet does not exist.
For the ImageComponent subcomponent
id property.
url property.toolTip property.alt property.visible property.renderer property.
For the Label subcomponent
id
property.for
property.text property.labelLevel property.toolTip property.visible property.renderer property.RadioButton properties mentioned above, the value binding is
set on the subcomponent for that property.
| Field Summary | |
|---|---|
static java.lang.String |
RB_ID
|
| Fields inherited from class com.sun.webui.jsf.component.RbCbSelector |
|---|
IMAGE_FACET, LABEL_FACET |
| Fields inherited from class javax.faces.component.UIInput |
|---|
COMPONENT_FAMILY, COMPONENT_TYPE, CONVERSION_MESSAGE_ID, REQUIRED_MESSAGE_ID, UPDATE_MESSAGE_ID |
| Fields inherited from interface javax.faces.component.NamingContainer |
|---|
SEPARATOR_CHAR |
| Constructor Summary | |
|---|---|
RadioButton()
Default constructor. |
|
| Method Summary | |
|---|---|
java.lang.String |
getFamily()
Return the family for this component. |
java.lang.String |
getHtmlTemplate()
Get alternative HTML template to be used by this component. |
java.lang.Object |
getItems()
Specifies the options that the web application user can choose from. |
java.lang.String |
getLabeledElementId(javax.faces.context.FacesContext context)
Returns the absolute ID of an HTML element suitable for use as the value of an HTML LABEL element's for attribute. |
int |
getLabelLevel()
Sets the style level for the generated label, provided the label attribute has been set. |
java.lang.String |
getOnSelect()
Scripting code executed when some text in this component value is selected. |
java.lang.String |
getRendererType()
|
static java.lang.Object |
getSelected(java.lang.String name)
Return the value of the selectedValue property
of the selected radio button in the group of radio buttons
identified by the name parameter. |
java.lang.Object |
getValue()
|
boolean |
isRequired()
|
void |
restoreState(javax.faces.context.FacesContext _context,
java.lang.Object _state)
Restore the state of this component. |
java.lang.Object |
saveState(javax.faces.context.FacesContext _context)
Save the state of this component. |
void |
setHtmlTemplate(java.lang.String htmlTemplate)
Set alternative HTML template to be used by this component. |
void |
setLabelLevel(int labelLevel)
Sets the style level for the generated label, provided the label attribute has been set. |
void |
validate(javax.faces.context.FacesContext context)
Update the request parameter that holds the value of the selectedValue property of the selected radio button. |
| Methods inherited from class com.sun.webui.jsf.component.RbCbSelector |
|---|
encodeBegin, getConvertedValue, getConvertedValue, getFocusElementId, getImageComponent, getImageURL, getIndicatorComponent, getLabelComponent, getName, getPrimaryElementID, getSelected, getSelectedValue, getValueExpression, isChecked, setImageURL, setItems, setName, setSelected, setSelectedValue, setValueExpression |
| Methods inherited from class com.sun.webui.jsf.component.Selector |
|---|
getLabel, getOnBlur, getOnChange, getOnClick, getOnDblClick, getOnFocus, getOnKeyDown, getOnKeyPress, getOnKeyUp, getOnMouseDown, getOnMouseMove, getOnMouseOut, getOnMouseOver, getOnMouseUp, getRendersChildren, getStyle, getStyleClass, getTabIndex, getToolTip, isDisabled, isMultiple, isReadOnly, isVisible, setDisabled, setLabel, setMultiple, setOnBlur, setOnChange, setOnClick, setOnDblClick, setOnFocus, setOnKeyDown, setOnKeyPress, setOnKeyUp, setOnMouseDown, setOnMouseMove, setOnMouseOut, setOnMouseOver, setOnMouseUp, setOnSelect, setReadOnly, setStyle, setStyleClass, setTabIndex, setToolTip, setVisible, toString |
| Methods inherited from class com.sun.webui.jsf.component.WebuiInput |
|---|
broadcast, getValidator, getValidatorExpression, getValueChangeListener, getValueChangeListenerExpression, processDecodes, processUpdates, processValidators, setConverter, setId, setImmediate, setRendered, setRequired, setValidatorExpression, setValueChangeListenerExpression |
| Methods inherited from class javax.faces.component.UIInput |
|---|
addValidator, addValueChangeListener, decode, getConverterMessage, getRequiredMessage, getSubmittedValue, getValidatorMessage, getValidators, getValueChangeListeners, isImmediate, isLocalValueSet, isValid, removeValidator, removeValueChangeListener, resetValue, setConverterMessage, setLocalValueSet, setRequiredMessage, setSubmittedValue, setValid, setValidator, setValidatorMessage, setValue, setValueChangeListener, updateModel |
| Methods inherited from class javax.faces.component.UIOutput |
|---|
getConverter, getLocalValue |
| Methods inherited from class javax.faces.component.UIComponentBase |
|---|
encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientId, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getParent, getValueBinding, invokeOnComponent, isRendered, isTransient, processRestoreState, processSaveState, queueEvent, restoreAttachedState, saveAttachedState, setParent, setRendererType, setTransient, setValueBinding |
| Methods inherited from class javax.faces.component.UIComponent |
|---|
encodeAll, getContainerClientId |
| Methods inherited from class java.lang.Object |
|---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Methods inherited from interface com.sun.webui.jsf.component.SelectorManager |
|---|
getClientId |
| Methods inherited from interface javax.faces.component.ValueHolder |
|---|
getConverter, getLocalValue |
| Field Detail |
|---|
public static final java.lang.String RB_ID
| Constructor Detail |
|---|
public RadioButton()
| Method Detail |
|---|
public java.lang.String getFamily()
Return the family for this component.
getFamily in class com.sun.webui.jsf.component.RbCbSelectorpublic java.lang.String getRendererType()
getRendererType in class javax.faces.component.UIComponentBasepublic static java.lang.Object getSelected(java.lang.String name)
selectedValue property
of the selected radio button in the group of radio buttons
identified by the name parameter.
A RadioButton is one of a group of radio buttons
if more than on radio button has the same value for the
name property.selectedValue property
is maintained in a request attribute identified by the value
of its name property.
name - the value a RadioButton name property.public java.lang.String getHtmlTemplate()
public void setHtmlTemplate(java.lang.String htmlTemplate)
public java.lang.String getLabeledElementId(javax.faces.context.FacesContext context)
for attribute.
If the ComplexComponent has sub-compoents, and one of
the sub-components is the target of a label, if that sub-component
is a ComplexComponent, then
getLabeledElementId must called on the sub-component and
the value returned. The value returned by this
method call may or may not resolve to a component instance.
If isReadOnly returns true, null is
returned.
getLabeledElementId in interface com.sun.webui.jsf.component.ComplexComponentgetLabeledElementId in class com.sun.webui.jsf.component.RbCbSelectorcontext - The FacesContext used for the request
for attribute.public void validate(javax.faces.context.FacesContext context)
Update the request parameter that holds the value of the
selectedValue property of the selected radio button.
name property has been set
a request attribute is created.
The value of the name property will
be used for the request attribute name and the value of the request
attribute will be the value of the
selectedValue property.
The request attribute described above is available during
a ValueChangeEvent.
validate in class javax.faces.component.UIInputcontext - The context of this request.public java.lang.Object getItems()
SelectorSpecifies the options that the web application user can choose
from. The value must be one of an array, Map or Collection
whose members are all subclasses ofcom.sun.webui.jsf.model.Option.
getItems in class com.sun.webui.jsf.component.RbCbSelectorpublic boolean isRequired()
isRequired in interface javax.faces.component.EditableValueHolderisRequired in class javax.faces.component.UIInputpublic java.lang.Object getValue()
getValue in interface javax.faces.component.ValueHoldergetValue in class javax.faces.component.UIOutputpublic java.lang.String getOnSelect()
SelectorScripting code executed when some text in this component value is selected.
getOnSelect in class Selectorpublic int getLabelLevel()
Sets the style level for the generated label, provided the label attribute has been set. Valid values are 1 (largest), 2 and 3 (smallest). The default value is 3.
getLabelLevel in class Selectorpublic void setLabelLevel(int labelLevel)
Sets the style level for the generated label, provided the label attribute has been set. Valid values are 1 (largest), 2 and 3 (smallest). The default value is 3.
setLabelLevel in class SelectorgetLabelLevel()
public void restoreState(javax.faces.context.FacesContext _context,
java.lang.Object _state)
Restore the state of this component.
restoreState in interface javax.faces.component.StateHolderrestoreState in class com.sun.webui.jsf.component.RbCbSelectorpublic java.lang.Object saveState(javax.faces.context.FacesContext _context)
Save the state of this component.
saveState in interface javax.faces.component.StateHoldersaveState in class com.sun.webui.jsf.component.RbCbSelector
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||