org.zkoss.jsf.zul
Class Radiogroup

java.lang.Object
  javax.faces.component.UIComponent
      javax.faces.component.UIComponentBase
          org.zkoss.jsf.zul.impl.AbstractComponent
              org.zkoss.jsf.zul.impl.LeafComponent
                  org.zkoss.jsf.zul.impl.BranchComponent
                      org.zkoss.jsf.zul.impl.BranchOutput
                          org.zkoss.jsf.zul.impl.BranchInput
                              org.zkoss.jsf.zul.impl.BaseRadiogroup
                                  org.zkoss.jsf.zul.Radiogroup

All Implemented Interfaces:

javax.faces.component.EditableValueHolder, javax.faces.component.StateHolder, javax.faces.component.ValueHolder, ClientInputSupport, ValueHolderSupport

public class Radiogroup
extends BaseRadiogroup

Radiogroup is a JSF component implementation for Radiogroup, This class also implements EditableValueHolder. That means you can use bidirectional value binding, immediate, required, converter, validator, valueChangeListener features on this component.
To use those features, you must declare a namespace of "http://java.sun.com/jsf/core" with a prefix (say 'f' in below example), add attribute of those feature with this namespace (for example f:required="true")in you jsf page. For more detail of EditableValueHolder features of JSF, you can refer to http://java.sun.com/products/jsp/

You must assign a value on each radio, so that, after user click radio and submitting, radiogroup will decode the request parameter and set back the submitted value to your bean.

The default binding value of this component is String

Example of use bidirectional value binding:

 <z:radiogroup id="r2" f:value="#{ConverterTestBean.value}" >
         <z:radio value="A" />
         <z:radio value="B" />
         <z:radio value="C" />
 </z:radiogroup>
 

Example of using immediate:

 <z:radiogroup f:immediate="true" />
 

Example of using required:

 <z:radiogroup f:required="true" />
 

Example of using converter:

 <z:radiogroup f:converter="yourBean.convertMethod"/>
 or
 <z:radiogroup >
        <f:converter converterId="yourConverterId"/>
 </z:radiogroup>
 

Example of using validator:

 <z:radiogroup f:validator="yourBean.validateMethod"/>
 or
 <z:radiogroup >
        <f:validator validatorId="yourValidatorId"/>
 </z:radiogroup>
  

Example of using converter:

 <z:radiogroup >
        <f:valueChangeListener type="your.ValueChangeListener"/>
 </z:radiogroup>
 

In some application server which doesn't support attribute namespace you can use attribute prefix 'f_' to replace attribute namespace
For example,

 <z:radiogroup f_value="#{yourBean.value}" />
 

This component should be declared nested under Page.

To know more ZK component features you can refer to http://www.zkoss.org/

Author:

Dennis.Chen

See Also:

Radiogroup, EditableValueHolder

Field Summary

Fields inherited from class org.zkoss.jsf.zul.impl.LeafComponent

_compAttrMap, _composer

Fields inherited from class javax.faces.component.UIComponent

bindings

Constructor Summary

Radiogroup()

Method Summary

Methods inherited from class org.zkoss.jsf.zul.impl.BaseRadiogroup

afterZULComponentComposed, clientInputDecode, getMappedAttributeName

Methods inherited from class org.zkoss.jsf.zul.impl.BranchInput

addErrorMessage, addValidator, addValueChangeListener, broadcast, compareValues, decode, getConvertedValue, getInputAttributeName, getInputAttributeValue, getSubmittedValue, getValidator, getValidators, getValueChangeListener, getValueChangeListeners, isImmediate, isRequired, isValid, processDecodes, processUpdates, processValidators, removeValidator, removeValueChangeListener, restoreState, saveState, setImmediate, setRequired, setSubmittedValue, setValid, setValidator, setValueChangeListener, updateModel, validate, validateValue

Methods inherited from class org.zkoss.jsf.zul.impl.BranchOutput

getConverter, getLocalValue, getValue, isLocalValueSet, setConverter, setLocalValueSet, setValue, transferValueForAttribute

Methods inherited from class org.zkoss.jsf.zul.impl.BranchComponent

loadZULTree

Methods inherited from class org.zkoss.jsf.zul.impl.LeafComponent

addZULDynamicAttribute, encodeBegin, encodeChildren, encodeEnd, evaluateDynaAttributes, getAttributeValue, getComponentDefName, getComponentInfo, getForward, getRendersChildren, getUse, getZULComponent, setAttributeValue, setForward, setId, setUse, setZULDynamicAttribute

Methods inherited from class org.zkoss.jsf.zul.impl.AbstractComponent

findAncestorWithClass, getBodyContent, getFacesContext, getFamily, getIf, getUnless, isEffective, isSuppressed, restoreAttachedMapState, saveAttachedMapState, setBodyContent, setIf, setSuppressed, setUnless

Methods inherited from class javax.faces.component.UIComponentBase

addFacesListener, findComponent, getAttributes, getChildCount, getChildren, getClientId, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getParent, getRenderer, getRendererType, getValueBinding, invokeOnComponent, isRendered, isTransient, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, setParent, setRendered, setRendererType, setTransient, setValueBinding

Methods inherited from class javax.faces.component.UIComponent

encodeAll, getContainerClientId, getValueExpression, setValueExpression

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.faces.component.EditableValueHolder

isLocalValueSet, setLocalValueSet

Methods inherited from interface javax.faces.component.ValueHolder

getConverter, getLocalValue, getValue, setConverter, setValue

Constructor Detail

Radiogroup

public Radiogroup()