org.zkoss.jsf.zul
Class Decimalbox

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.BaseDecimalbox
                                  org.zkoss.jsf.zul.Decimalbox

All Implemented Interfaces:

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

public class Decimalbox
extends BaseDecimalbox

Decimalbox is a JSF component implementation for Decimalbox, 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/

The default binding value of this component is BigDecimal

Example of use bidirectional value binding:

 <z:decimalbox f:value="#{yourBean.value}" />
 

Example of using immediate:

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

Example of using required:

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

Example of using converter:

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

Example of using validator:

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

Example of using converter:

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

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

 <z:decimalbox 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:

Decimalbox, EditableValueHolder

Nested Class Summary

Nested classes/interfaces inherited from class org.zkoss.jsf.zul.impl.BaseDecimalbox

BaseDecimalbox.DecimalFormatConverter

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

Decimalbox()

Method Summary

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

afterZULComponentComposed, getMappedAttributeName

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

addErrorMessage, addValidator, addValueChangeListener, broadcast, clientInputDecode, 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

Decimalbox

public Decimalbox()