org.zkoss.jsf.zul
Class Calendar

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.BaseCalendar
                                  org.zkoss.jsf.zul.Calendar

All Implemented Interfaces:

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

public class Calendar
extends BaseCalendar

Calendar is a JSF component implementation for Calendar, 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 Date

Example of use bidirectional value binding:

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

Example of using immediate:

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

Example of using required:

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

Example of using converter:

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

Example of using validator:

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

Example of using converter:

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

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

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

Calendar, EditableValueHolder

Nested Class Summary

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

BaseCalendar.DateFormatConverter

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

Calendar()

Method Summary

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

afterZULComponentComposed, transferValueForAttribute

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, getMappedAttributeName, getValue, isLocalValueSet, setConverter, setLocalValueSet, setValue

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

Calendar

public Calendar()