org.zkoss.zul

Class Calendar

java.lang.Object

org.zkoss.zk.ui.AbstractComponent

org.zkoss.zk.ui.HtmlBasedComponent

org.zkoss.zul.impl.XulElement

org.zkoss.zul.Calendar

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, Component, Scope, ComponentCtrl, Constrainted

public class Calendar
extends XulElement
implements Constrainted

A calendar.

Default getZclass(): z-calendar. (since 3.5.0)

Support display the week number within the current year

Events: onWeekClick

For example

 <calendar weekOfYear="true" onWeekClick='alert(event.data)'/>
 

[ZK EE] [Since 6.5.0]

Author:

tomyeh

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.zkoss.zk.ui.HtmlBasedComponent

HtmlBasedComponent.ExtraCtrl

Nested classes/interfaces inherited from class org.zkoss.zk.ui.AbstractComponent

AbstractComponent.Children

Field Summary

Fields inherited from class org.zkoss.zk.ui.HtmlBasedComponent

_zclass

Fields inherited from interface org.zkoss.zk.ui.Component

APPLICATION_SCOPE, COMPONENT_SCOPE, DESKTOP_SCOPE, PAGE_SCOPE, REQUEST_SCOPE, SESSION_SCOPE, SPACE_SCOPE

Fields inherited from interface org.zkoss.zk.ui.sys.ComponentCtrl

AFTER_CHILD_ADDED, AFTER_CHILD_REMOVED, AFTER_PAGE_ATTACHED, AFTER_PAGE_DETACHED, CE_BUSY_IGNORE, CE_DUPLICATE_IGNORE, CE_IMPORTANT, CE_NON_DEFERRABLE, CE_REPEAT_IGNORE

Constructor Summary

Constructors

Constructor and Description
Calendar()
Calendar(java.util.Date value)
Calendar(java.time.LocalDate value)
Calendar(java.time.LocalDateTime value)
Calendar(java.time.ZonedDateTime value)

Method Summary

Modifier and Type	Method and Description
Constraint	getConstraint() Returns the constraint, or null if no constraint at all.
java.lang.String	getName() Returns the name of this component.
boolean	getShowTodayLink() Returns whether enable to show the link that jump to today in day view Default: false
java.util.TimeZone	getTimeZone() Deprecated. As of release 5.0.5, it is meaningless to set time zone for a calendar.
java.lang.String	getTodayLinkLabel() Returns the label of the link that jump to today in day view Default: Today
java.util.Date	getValue() Returns the value that is assigned to this component, never null.
java.time.LocalDate	getValueInLocalDate() Returns the value (in LocalDate) that is assigned to this component, never null.
java.time.LocalDateTime	getValueInLocalDateTime() Returns the value (in LocalDateTime) that is assigned to this component, never null.
java.time.LocalTime	getValueInLocalTime() Returns the value (in LocalTime) that is assigned to this component, never null.
java.time.ZonedDateTime	getValueInZonedDateTime() Returns the value (in ZonedDateTime) that is assigned to this component, never null.
java.lang.String	getZclass() Returns the ZK Cascading Style class(es) for this component.
boolean	isWeekOfYear() Returns whether enable to show the week number within the current year or not.
protected void	renderProperties(ContentRenderer renderer) Renders the content of this component, excluding the enclosing tags and children.
void	service(AuRequest request, boolean everError) Processes an AU request.
void	setConstraint(Constraint constr) Sets the constraint.
void	setConstraint(java.lang.String constr) Sets a list of constraints separated by comma.
void	setName(java.lang.String name) Sets the name of this component.
void	setShowTodayLink(boolean showTodayLink) Sets whether enable to show the link that jump to today in day view
void	setTimeZone(java.util.TimeZone tzone) As of release 5.0.5, it is meaningless to set time zone for a calendar.
void	setTodayLinkLabel(java.lang.String todayLinkLabel) Sets the label of the link that jump to today in day view
void	setValue(java.util.Date value) Assigns a value to this component.
void	setValueInLocalDate(java.time.LocalDate value) Assigns a value (in LocalDate) to this component.
void	setValueInLocalDateTime(java.time.LocalDateTime value) Assigns a value (in LocalDateTime) to this component.
void	setValueInLocalTime(java.time.LocalTime value) It is meaningless to set only LocalTime in calendar.
void	setValueInZonedDateTime(java.time.ZonedDateTime value) Assigns a value (in ZonedDateTime) to this component.
void	setWeekOfYear(boolean weekOfYear) Sets whether enable to show the week number within the current year or not.

Methods inherited from class org.zkoss.zul.impl.XulElement

clone, getContext, getCtrlKeys, getPopup, getPropertyAccess, getTooltip, setContext, setContext, setContextAttributes, setCtrlKeys, setPopup, setPopup, setPopupAttributes, setTooltip, setTooltip, setTooltipAttributes

Methods inherited from class org.zkoss.zk.ui.HtmlBasedComponent

addSclass, evalCSSFlex, focus, getAction, getDraggable, getDroppable, getExtraCtrl, getHeight, getHflex, getLeft, getRenderdefer, getSclass, getStyle, getTabindex, getTabindexInteger, getTooltiptext, getTop, getVflex, getWidth, getZindex, getZIndex, removeSclass, removeSclass, setAction, setClass, setDraggable, setDroppable, setFocus, setHeight, setHeight0, setHeightDirectly, setHflex, setHflex0, setHflexDirectly, setLeft, setLeftDirectly, setRenderdefer, setSclass, setStyle, setTabindex, setTabindex, setTooltiptext, setTop, setTopDirectly, setVflex, setVflex0, setVflexDirectly, setWidth, setWidth0, setWidthDirectly, setZclass, setZindex, setZIndex, setZIndexDirectly

Methods inherited from class org.zkoss.zk.ui.AbstractComponent

addAnnotation, addAnnotation, addCallback, addClientEvent, addEventHandler, addEventListener, addEventListener, addForward, addForward, addForward, addForward, addMoved, addRedrawCallback, addScopeListener, addShadowRoot, addShadowRootBefore, addSharedEventHandlerMap, appendChild, applyProperties, beforeChildAdded, beforeChildRemoved, beforeParentChanged, detach, didActivate, didActivate, didDeserialize, didDeserialize, disableBindingAnnotation, disableClientUpdate, enableBindingAnnotation, getAnnotatedProperties, getAnnotatedPropertiesBy, getAnnotation, getAnnotation, getAnnotations, getAnnotations, getAnnotations, getAttribute, getAttribute, getAttribute, getAttributeOrFellow, getAttributes, getAttributes, getAuService, getAutag, getCallback, getChildren, getClientAttribute, getClientDataAttribute, getClientEvents, getDefaultMold, getDefinition, getDesktop, getEventHandler, getEventHandlerNames, getEventListenerMap, getEventListeners, getFellow, getFellow, getFellowIfAny, getFellowIfAny, getFellows, getFirstChild, getId, getLastChild, getListenerIterator, getMold, getNextSibling, getPage, getParent, getPreviousSibling, getRedrawCallback, getRoot, getShadowFellowIfAny, getShadowRoots, getShadowVariable, getShadowVariable, getShadowVariable0, getSpaceOwner, getSpecialRendererOutput, getStubonly, getSubBindingAnnotationCount, getTemplate, getTemplateNames, getUuid, getWidgetAttribute, getWidgetAttributeNames, getWidgetClass, getWidgetListener, getWidgetListenerNames, getWidgetOverride, getWidgetOverrideNames, hasAttribute, hasAttribute, hasAttribute, hasAttributeOrFellow, hasBindingAnnotation, hasFellow, hasFellow, hasSubBindingAnnotation, insertBefore, invalidate, invalidatePartial, isChildable, isInitialized, isInvalidated, isListenerAvailable, isVisible, onChildAdded, onChildRemoved, onPageAttached, onPageDetached, onWrongValue, query, queryAll, redraw, redrawChildren, removeAttribute, removeAttribute, removeAttribute, removeCallback, removeChild, removeEventListener, removeForward, removeForward, removeRedrawCallback, removeScopeListener, removeShadowRoot, render, render, render, replace, response, response, response, service, sessionDidActivate, sessionWillPassivate, setAttribute, setAttribute, setAttribute, setAuService, setAutag, setClientAttribute, setClientDataAttribute, setDefinition, setDefinition, setId, setMold, setPage, setPageBefore, setParent, setStubonly, setStubonly, setSubBindingAnnotationCount, setTemplate, setVisible, setVisibleDirectly, setWidgetAttribute, setWidgetClass, setWidgetListener, setWidgetOverride, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdate, smartUpdateWidgetListener, smartUpdateWidgetOverride, toString, updateByClient, updateSubBindingAnnotationCount, willPassivate, willPassivate, willSerialize, willSerialize

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.zkoss.zk.ui.sys.ComponentCtrl

invalidatePartial

Constructor Detail

Calendar

public Calendar()

Calendar

public Calendar(java.util.Date value)

Calendar

public Calendar(java.time.ZonedDateTime value)

Calendar

public Calendar(java.time.LocalDateTime value)

Calendar

public Calendar(java.time.LocalDate value)

Method Detail

setWeekOfYear

public void setWeekOfYear(boolean weekOfYear)

Sets whether enable to show the week number within the current year or not. [ZK EE]

Since:

6.5.0

isWeekOfYear

public boolean isWeekOfYear()

Returns whether enable to show the week number within the current year or not.

Default: false

Since:

6.5.0

getTimeZone

public java.util.TimeZone getTimeZone()

Deprecated. As of release 5.0.5, it is meaningless to set time zone for a calendar.

setTimeZone

public void setTimeZone(java.util.TimeZone tzone)

As of release 5.0.5, it is meaningless to set time zone for a calendar.

getValue

public java.util.Date getValue()

Returns the value that is assigned to this component, never null.

setValue

public void setValue(java.util.Date value)

Assigns a value to this component.

Parameters:

value - the date to assign. If null, today is assumed.

getValueInZonedDateTime

public java.time.ZonedDateTime getValueInZonedDateTime()

Returns the value (in ZonedDateTime) that is assigned to this component, never null.

Since:

9.0.0

setValueInZonedDateTime

public void setValueInZonedDateTime(java.time.ZonedDateTime value)

Assigns a value (in ZonedDateTime) to this component.

Parameters:

value - the date to assign. If null, today is assumed.

Since:

9.0.0

getValueInLocalDateTime

public java.time.LocalDateTime getValueInLocalDateTime()

Returns the value (in LocalDateTime) that is assigned to this component, never null.

Since:

9.0.0

setValueInLocalDateTime

public void setValueInLocalDateTime(java.time.LocalDateTime value)

Assigns a value (in LocalDateTime) to this component.

Parameters:

value - the date to assign. If null, today is assumed.

Since:

9.0.0

getValueInLocalDate

public java.time.LocalDate getValueInLocalDate()

Returns the value (in LocalDate) that is assigned to this component, never null.

Since:

9.0.0

setValueInLocalDate

public void setValueInLocalDate(java.time.LocalDate value)

Assigns a value (in LocalDate) to this component.

Parameters:

value - the date to assign. If null, today is assumed.

Since:

9.0.0

getValueInLocalTime

public java.time.LocalTime getValueInLocalTime()

Returns the value (in LocalTime) that is assigned to this component, never null.

Since:

9.0.0

setValueInLocalTime

public void setValueInLocalTime(java.time.LocalTime value)
                         throws WrongValueException

It is meaningless to set only LocalTime in calendar.

Throws:

WrongValueException

Since:

9.0.0

getName

public java.lang.String getName()

Returns the name of this component.

Default: null.

The name is used only to work with "legacy" Web application that handles user's request by servlets. It works only with HTTP/HTML-based browsers. It doesn't work with other kind of clients.

Don't use this method if your application is purely based on ZK's event-driven model.

Since:

3.0.0

setName

public void setName(java.lang.String name)

Sets the name of this component.

The name is used only to work with "legacy" Web application that handles user's request by servlets. It works only with HTTP/HTML-based browsers. It doesn't work with other kind of clients.

Don't use this method if your application is purely based on ZK's event-driven model.

Parameters:

name - the name of this component.

Since:

3.0.0

getShowTodayLink

public boolean getShowTodayLink()

Returns whether enable to show the link that jump to today in day view

Default: false

Returns:

boolean

Since:

8.0.0

setShowTodayLink

public void setShowTodayLink(boolean showTodayLink)

Sets whether enable to show the link that jump to today in day view

Parameters:

showTodayLink - show or hidden

Since:

8.0.0

getTodayLinkLabel

public java.lang.String getTodayLinkLabel()

Returns the label of the link that jump to today in day view

Default: Today

Returns:

String

Since:

8.0.4

setTodayLinkLabel

public void setTodayLinkLabel(java.lang.String todayLinkLabel)

Sets the label of the link that jump to today in day view

Parameters:

todayLinkLabel - today link label

Since:

8.0.4

setConstraint

public void setConstraint(java.lang.String constr)

Sets a list of constraints separated by comma. Example: "between 20071012 and 20071223", "before 20080103".

Parameters:

constr - a list of constraints separated by comma.

setConstraint

public void setConstraint(Constraint constr)

Description copied from interface: Constrainted

Sets the constraint.

Default: null (means no constraint all all).

Specified by:

setConstraint in interface Constrainted

getConstraint

public Constraint getConstraint()

Description copied from interface: Constrainted

Returns the constraint, or null if no constraint at all.

Specified by:

getConstraint in interface Constrainted

getZclass

public java.lang.String getZclass()

Description copied from class: HtmlBasedComponent

Returns the ZK Cascading Style class(es) for this component. It usually depends on the implementation of the mold (AbstractComponent.getMold()).

Default: null (the default value depends on element).

HtmlBasedComponent.setZclass(java.lang.String)) will completely replace the default style of a component. In other words, the default style of a component is associated with the default value of HtmlBasedComponent.getZclass(). Once it is changed, the default style won't be applied at all. If you want to perform small adjustments, use HtmlBasedComponent.setSclass(java.lang.String) instead.

Overrides:

getZclass in class HtmlBasedComponent

See Also:

HtmlBasedComponent.getSclass()

service

public void service(AuRequest request,
                    boolean everError)

Processes an AU request.

Default: in addition to what are handled by HtmlBasedComponent.service(org.zkoss.zk.au.AuRequest, boolean), it also handles onChange, onChanging and onError.

Specified by:

service in interface ComponentCtrl

Overrides:

service in class HtmlBasedComponent

everError - whether any error ever occurred before processing this request.

Since:

5.0.0

See Also:

AbstractComponent.setAuService(org.zkoss.zk.au.AuService)

renderProperties

protected void renderProperties(ContentRenderer renderer)
                         throws java.io.IOException

Description copied from class: HtmlBasedComponent

Renders the content of this component, excluding the enclosing tags and children.

See also ZK Client-side Reference: Property Rendering

Overrides:

renderProperties in class XulElement

Throws:

java.io.IOException