RichFaces ( Legacy URL )
Tag calendar


The <rich:calendar> component is a UI control used for creating graphical monthly calendar on a page.


Tag Information
Tag Classorg.richfaces.taglib.CalendarTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
ajaxSinglefalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
boolean attribute which provides possibility to limit JSF tree processing(decoding, conversion/validation, value applying) to the component which send the request only. Default value is "true"
bindingfalsefalsejavax.el.ValueExpression
(must evaluate to javax.faces.component.UIComponent)
The attribute takes a value-binding expression for a component property of a backing bean
boundaryDatesModefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
This attribute is responsible for behaviour of dates from the previous and next months which are displayed in the current month. Valid values are "inactive" (Default) dates inactive and gray colored, "scroll" boundaries work as month scrolling controls, and "select" boundaries work in the same way as "scroll" but with the date clicked selection. Default value is "inactive".
buttonClassfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Style Class attribute for the popup button
buttonIconfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Defines icon for the popup button element. The attribute is ignored if the "buttonLabel" is set
buttonIconDisabledfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Defines disabled icon for the popup button element. The attribute is ignored if the "buttonLabel" is set
buttonLabelfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Defines label for the popup button element. If the attribute is set "buttonIcon" and "buttonIconDisabled" are ignored
bypassUpdatesfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If "true", after process validations phase it skips updates of model beans on a force render response. It can be used for validating components input
cellHeightfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
attribute to set fixed cells height
cellWidthfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
attribute to set fixed cells width
converterfalsefalsejavax.el.ValueExpression
(must evaluate to javax.faces.convert.Converter)
Id of Converter to be used or reference to a Converter
converterMessagefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
A ValueExpression enabled attribute that, if present, will be used as the text of the converter message, replacing any message that comes from the converter
currentDatefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Defines current date
currentDateChangeListenerfalsefalsejavax.el.MethodExpression
(signature must match void currentDateChangeListener(org.richfaces.event.CurrentDateChangeEvent))
MethodExpression representing an action listener method that will be notified after date selection
dataModelfalsefalsejavax.el.ValueExpression
(must evaluate to org.richfaces.model.CalendarDataModel)
Used to provide data for calendar elements. If data is not provided, all Data Model related functions are disabled
datePatternfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Defines date pattern. Default value is "MMM d, yyyy".
dayStyleClassfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Should be binded to some JS function that will provide style classes for special sets of days highlighting.
defaultTimefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Defines time that will be used: 1) to set time when the value is empty 2) to set time when date changes and flag "resetTimeOnDateSelect" is true. Default value is "getDefaultValueOfDefaultTime()"
directionfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Defines direction of the calendar popup ("top-left", "top-right", "bottom-left", "bottom-right" (Default), "auto"). Default value is "bottom-right".
disabledfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If "true", rendered is disabled. In "popup" mode both controls are disabled. Default value is "false".
enableManualInputfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If "true" calendar input will be editable and it will be possible to change the date manualy. If "false" value for this attribute makes a text field "read-only", so the value can be changed only from a handle. Default value is "false".
eventsQueuefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Name of requests queue to avoid send next request before complete other from same event. Can be used to reduce number of requests of frequently events (key press, mouse move etc.)
firstWeekDayfalsefalsejavax.el.ValueExpression
(must evaluate to int)
Gets what the first day of the week is; e.g., SUNDAY in the U.S., MONDAY in France. Default value is "getDefaultFirstWeekDay()". Possible values should be integers from 0 to 6, 0 corresponds to Sunday
focusfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
id of element to set focus after request completed on client side
horizontalOffsetfalsefalsejavax.el.ValueExpression
(must evaluate to int)
Sets the horizontal offset between button and calendar element conjunction point. Default value is "0".
idfalsefalsejava.lang.StringEvery component may have a unique id that is automatically created if omitted
ignoreDupResponsesfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
Attribute allows to ignore an Ajax Response produced by a request if the newest 'similar' request is in a queue already. ignoreDupResponses="true" does not cancel the request while it is processed on the server, but just allows to avoid unnecessary updates on the client side if the response isn't actual now
immediatefalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
A flag indicating that this component value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until a Process Validations phase
inputClassfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Style Class attribute for the text field
inputSizefalsefalsejavax.el.ValueExpression
(must evaluate to int)
Defines the size of an input field. Similar to the "size" attribute of <h:inputText/>
inputStylefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Style attribute for text field
isDayEnabledfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Should be binded to some JS function that returns day state.
jointPointfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Set the corner of the button for the popup to be connected with (top-left, top-right, bottom-left (Default), bottom-right, auto). Default value is "bottom-left".
labelfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
A localized user presentable name for this component.
limitToListfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If "true", then of all AJAX-rendered on the page components only those will be updated, which ID's are passed to the "reRender" attribute of the describable component. "false"-the default value-means that all components with ajaxRendered="true" will be updated.
localefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Used for locale definition. Default value is "getDefaultLocale()".
minDaysInFirstWeekfalsefalsejavax.el.ValueExpression
(must evaluate to int)
Gets what the minimal days required in the first week of the year are; e.g., if the first week is defined as one that contains the first day of the first month of a year, this method returns 1. If the minimal days required must be a full week, this method returns 7. Default value is "getDefaultMinDaysInFirstWeek()".
modefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Valid values: ajax or client. Default value is "client".
monthLabelsfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Attribute that allows to customize names of the months. Should accept list with the month names
monthLabelsShortfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Attribute that allows to customize short names of the months. Should accept list with the month names
onbeforedomupdatefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
JavaScript code for call before DOM has been updated on client side
onchangedfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; to invoke when date or time was changed and applied to input
oncollapsefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; calendar was closed
oncompletefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
JavaScript code for call after request completed on client side
oncurrentdateselectfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; to invoke before current month was changed
oncurrentdateselectedfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; to invoke after current month was changed
ondatemouseoutfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: a script expression; a pointer is moved away the date cell
ondatemouseoverfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; to invoke when a pointer is moved to the date cell
ondateselectfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; to invoke before some date cell was selected.
ondateselectedfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; to invoke after some date cell selected.
onexpandfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; calendar was opened
oninputblurfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; the input field lost the focus
oninputchangefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; the input field is changed
oninputclickfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: a script expression; the input field is clicked
oninputfocusfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; the input field got the focus
oninputkeydownfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: a script expression; a key for the input field is pressed down
oninputkeypressfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: a script expression; a key for the input field is pressed and released
oninputkeyupfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: a script expression; a key for the input field is released
oninputmouseoutfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: a script expression; a pointer is moved away
oninputmouseoverfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: a script expression; a pointer is moved onto
oninputselectfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; the input field is selected
ontimeselectfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; to invoke before new time was selected
ontimeselectedfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
HTML: script expression; to invoke after time selected
popupfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If "true" calendar will be rendered initially as hidden with additional elements for calling as popup. Default value is "true".
preloadDateRangeBeginfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Define the initial range of date which will be loaded to client from dataModel under rendering. Default value is "getDefaultPreloadBegin(getCurrentDateOrDefault())".
preloadDateRangeEndfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Defines the last range of date which will be loaded to client from dataModel under rendering. Default value is "getDefaultPreloadEnd(getCurrentDateOrDefault())".
processfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Id['s] (in format of call UIComponent.findComponent()) of components, processed at the phases 2-5 in case of AjaxRequest caused by this component. Can be single id, comma-separated list of Id's, or EL Expression with array or Collection
reRenderfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Id['s] (in format of call UIComponent.findComponent()) of components, rendered in case of AjaxRequest caused by this component. Can be single id, comma-separated list of Id's, or EL Expression with array or Collection
readonlyfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If "true". Date and time are not selectable. In "popup" mode input is disabled and button is enabled. Default value is "false".
renderedfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If "false", this component is not rendered
requestDelayfalsefalsejavax.el.ValueExpression
(must evaluate to int)
Attribute defines the time (in ms.) that the request will be wait in the queue before it is ready to send. When the delay time is over, the request will be sent to the server or removed if the newest 'similar' request is in a queue already
requiredfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If "true", this component is checked for non-empty input
requiredMessagefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
A ValueExpression enabled attribute that, if present, will be used as the text of the validation message for the "required" facility, if the "required" facility is used
resetTimeOnDateSelectfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If value is true then calendar should change time to defaultTime for newly-selected dates. Default value is "false"
showApplyButtonfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If false ApplyButton should not be shown. Default value is "false".
showFooterfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If false Calendar's footer should not be shown. Default value is "true".
showHeaderfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If false Calendar's header should not be shown. Default value is "true".
showInputfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
"false" value for this attribute makes text field invisible. It works only if popupMode="true" If showInput is "true" - input field will be shown. Default value is "true".
showWeekDaysBarfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If false this bar should not be shown. Default value is "true".
showWeeksBarfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
If false this bar should not be shown. Default value is "true".
similarityGroupingIdfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
If there are any component requests with identical IDs then these requests will be grouped.
statusfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
ID (in format of call UIComponent.findComponent()) of Request status component
stylefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
CSS style(s) is/are to be applied when this component is rendered
styleClassfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Corresponds to the HTML class attribute
tabIndexfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
tabIndex
tabindexfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
This attribute specifies the position of the current element in the tabbing order for the current document. This value must be a number between 0 and 32767. User agents should ignore leading zeros
timeZonefalsefalsejavax.el.ValueExpression
(must evaluate to java.util.TimeZone)
Used for current date calculations. Default value is "getDefaultTimeZone()".
timeoutfalsefalsejavax.el.ValueExpression
(must evaluate to int)
Response waiting time on a particular request. If a response is not received during this time, the request is aborted
todayControlModefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
This attribute defines the mode for "today" control. Possible values are "scroll", "select", "hidden". Default value is "select".
validatorfalsefalsejavax.el.MethodExpression
(signature must match void validator(javax.faces.context.FacesContext, javax.faces.component.UIComponent, java.lang.Object))
MethodBinding pointing at a method that is called during Process Validations phase of the request processing lifecycle, to validate the current value of this component
validatorMessagefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
A ValueExpression enabled attribute that, if present, will be used as the text of the validator message, replacing any message that comes from the validator
valuefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
The current value of this component
valueChangeListenerfalsefalsejavax.el.MethodExpression
(signature must match void valueChangeListener(javax.faces.event.ValueChangeEvent))
Listener for value changes
verticalOffsetfalsefalsejavax.el.ValueExpression
(must evaluate to int)
Sets the vertical offset between button and calendar element conjunction point. Default value is "0".
weekDayLabelsfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
List of the day names displays on the days bar in the following way "Sun, Mon, Tue, Wed, "
weekDayLabelsShortfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
Attribute that allows to customize short names of the weeks. Should accept list with the weeks names.
zindexfalsefalsejavax.el.ValueExpression
(must evaluate to int)
Attribute is similar to the standard HTML attribute and can specify window placement relative to the content. Default value is "3".

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.