01: /* Datebox.java
02:
03: {{IS_NOTE
04: Purpose:
05:
06: Description:
07:
08: History:
09: Aug 8, 2007 5:48:27 PM 2007, Created by Dennis.Chen
10: }}IS_NOTE
11:
12: Copyright (C) 2007 Potix Corporation. All Rights Reserved.
13:
14: {{IS_RIGHT
15: This program is distributed under GPL Version 2.0 in the hope that
16: it will be useful, but WITHOUT ANY WARRANTY.
17: }}IS_RIGHT
18: */
19: package org.zkoss.jsf.zul;
20:
21: import org.zkoss.jsf.zul.impl.BaseTimebox;
22: import org.zkoss.zk.ui.Component;
23:
24: /**
25: * Timebox is a JSF component implementation for {@link org.zkoss.zul.Timebox},
26: * This class also implements {@link javax.faces.component.EditableValueHolder}.
27: * That means you can use bidirectional value binding, immediate, required, converter, validator, valueChangeListener features on this component.
28: * <br/>
29: * To use those features, you must declare a namespace of "http://java.sun.com/jsf/core"
30: * with a prefix (say 'f' in below example), add attribute of those feature with this namespace
31: * (for example f:required="true")in the jsf page.
32: * For more detail of EditableValueHolder features of JSF, you can refer to <a href="http://java.sun.com/products/jsp/">http://java.sun.com/products/jsp/</a>
33: *
34: * <p/>
35: * The default binding value of this component is {@link java.util.Date}
36: *
37: * <p/>
38: * Example of use bidirectional value binding:<br/>
39: * <pre>
40: * <z:timebox f:value="#{yourBean.value}" />
41: * </pre>
42: *
43: *
44: * <p/>
45: * Example of using immediate:<br/>
46: * <pre>
47: * <z:timebox f:immediate="true" />
48: * </pre>
49: *
50: * <p/>
51: * Example of using required:<br/>
52: * <pre>
53: * <z:timebox f:required="true" />
54: * </pre>
55: * <p/>
56: * Example of using converter:<br/>
57: * <pre>
58: * <z:timebox f:converter="yourBean.convertMethod"/>
59: * or
60: * <z:timebox >
61: * <f:converter converterId="yourConverterId"/>
62: * </z:timebox>
63: * </pre>
64: * <p/>
65: * Example of using validator:<br/>
66: * <pre>
67: * <z:timebox f:validator="yourBean.validateMethod"/>
68: * or
69: * <z:timebox >
70: * <f:validator validatorId="yourValidatorId"/>
71: * </z:timebox>
72: * </pre>
73: * <p/>
74: * Example of using converter:<br/>
75: * <pre>
76: * <z:timebox >
77: * <f:valueChangeListener type="your.ValueChangeListener"/>
78: * </z:timebox>
79: * </pre>
80: * <p/>
81: * In some application server which doesn't support attribute namespace you can use attribute prefix 'f_' to replace attribute namespace
82: * <br/>
83: * For example,
84: * <pre>
85: * <z:timebox f_value="#{yourBean.value}" />
86: * </pre>
87: *
88: * <p/>
89: * This component should be declared nested under {@link org.zkoss.jsf.zul.Page}.
90: *
91: * <p/>To know more ZK component features you can refer to <a href="http://www.zkoss.org/">http://www.zkoss.org/</a>
92: *
93: * @author Dennis.Chen
94: * @see org.zkoss.zul.Timebox
95: * @see javax.faces.component.EditableValueHolder
96: */
97: public class Timebox extends BaseTimebox {
98:
99: }
|