The <rich:calendar> component allows the user to enter a date and time through an in-line or pop-up calendar. The pop-up calendar can navigate through months and years, and its look and feel can be highly customized.
@author amarkhel| Info | Value |
|---|---|
| Component Type | org.richfaces.Calendar |
| Handler Class | org.richfaces.view.facelets.CalendarHandler |
| Renderer Type | org.richfaces.CalendarRenderer |
| Description | The <rich:calendar> component allows the user to enter a date and time through an in-line or pop-up calendar. The pop-up calendar can navigate through months and years, and its look and feel can be highly customized. @author amarkhel |
| Name | Required | Type | Description |
|---|---|---|---|
binding |
false
| javax.el.ValueExpression
(must evaluate to javax.faces.component.UIComponent)
| The value binding expression used to wire up this component to a component property of a JavaBean class |
boundaryDatesMode |
false
| javax.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" |
buttonClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) to be applied to the button element. This value must be passed through as the "class" attribute on generated markup. |
buttonDisabledIcon |
false
| javax.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 |
buttonIcon |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Defines icon for the popup button element. The attribute is ignored if the "buttonLabel" is set |
buttonLabel |
false
| javax.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 |
converter |
false
| javax.el.ValueExpression
(must evaluate to javax.faces.convert.Converter)
| Converter instance registered with this component. |
converterMessage |
false
| javax.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. |
currentDate |
false
| javax.el.ValueExpression
(must evaluate to java.lang.Object)
| Used to define the month and year which will be displayed |
dataModel |
false
| javax.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 |
datePattern |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Used to format the date and time strings, according to ISO 8601 (for example, d/M/yy HH:mm a) |
dayClassFunction |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The javascript function that determines the CSS style class for each day cell |
dayDisableFunction |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The javascript function that enables or disables a day cell |
defaultLabel |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The starting label can be set when in the initial view state. If the initial value is already set through the value attribute, this is displayed instead. |
defaultTime |
false
| javax.el.ValueExpression
(must evaluate to java.lang.Object)
| Defines time that will be used:
Default value is "getDefaultValueOfDefaultTime()" |
direction |
false
| javax.el.ValueExpression
(must evaluate to org.richfaces.component.Positioning)
| Set the direction of the popup. Possible values are: Default value is auto |
disabled |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| If "true", rendered is disabled. In "popup" mode both controls are disabled Default value is "false" |
enableManualInput |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| If "true" calendar input will be editable and it will be possible to change the date manually. If "false" the text field will be "read-only", so the value can be changed only from a handle. Default value is "false" |
firstWeekDay |
false
| javax.el.ValueExpression
(must evaluate to int)
| Determines the first day of the week is; e.g., SUNDAY in the U.S., MONDAY in France. Possible values should be integers from 0 to 6, 0 corresponds to Sunday Default value is "getDefaultFirstWeekDay()" |
horizontalOffset |
false
| javax.el.ValueExpression
(must evaluate to int)
| Sets the horizontal offset between popup element and the conjunction point Default value is 0 |
id |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The component identifier for this component. This value must be unique within the closest parent component that is a naming container. |
immediate |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| Flag indicating that this component's value must be converted and validated immediately (that is, during Apply Request Values phase), rather than waiting until Process Validations phase. |
inputClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) to be applied to the input element. This value must be passed through as the "class" attribute on generated markup. |
inputSize |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Defines the size of an input field. Similar to the "size" attribute of <h:inputText/> |
inputStyle |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| CSS style(s) to be applied to the input element |
jointPoint |
false
| javax.el.ValueExpression
(must evaluate to org.richfaces.component.Positioning)
| Set the corner attachment point with which the popup should be connected. Possible values are: Default value is auto |
locale |
false
| javax.el.ValueExpression
(must evaluate to java.lang.Object)
| Used for locale definition Default value is "getDefaultLocale()" |
minDaysInFirstWeek |
false
| javax.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()" |
mode |
false
| javax.el.ValueExpression
(must evaluate to org.richfaces.component.AbstractCalendar.Mode)
| Valid values: ajax or client Default value is "client" |
monthLabels |
false
| javax.el.ValueExpression
(must evaluate to java.lang.Object)
| Attribute that allows to customize names of the months. Should accept list with the month names |
monthLabelsShort |
false
| javax.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 |
onbeforecurrentdateselect |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side script method to be called before the current month or year is changed |
onbeforedateselect |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side script method to be called before some date cell is selected |
onbeforetimeselect |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side script method to be called before time is selected |
onchange |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when this element loses focus and its value has been modified since gaining focus. |
onclean |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side script method to be called before the component is cleaned |
oncomplete |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side script method to be called after the DOM is updated |
oncurrentdateselect |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side script method to be called when the current month or year is changed |
ondatemouseout |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side script method to be called when a pointer is moved away from the date cell |
ondatemouseover |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side script method to be called when a pointer is moved onto the date cell |
ondateselect |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side script method to be called when some date cell is selected |
onhide |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side code executed after the popup disappears. |
oninputblur |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when the input element loses focus. |
oninputchange |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when the input field value is changed manually |
oninputclick |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is clicked over the input element. |
oninputdblclick |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is double clicked over the input element. |
oninputfocus |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when the input element receives focus. |
oninputkeydown |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a key is pressed down over the input element. |
oninputkeypress |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a key is pressed and released over the input element. |
oninputkeyup |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a key is released over the input element. |
oninputmousedown |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is pressed down over the input element. |
oninputmousemove |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is moved within the input element. |
oninputmouseout |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is moved away from the input element. |
oninputmouseover |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is moved onto the input element. |
oninputmouseup |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed when a pointer button is released over the input element. |
oninputselect |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Javascript code executed called when the input field value is selected |
onshow |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side code executed after the popup is shown. |
ontimeselect |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| The client-side script method to be called after time is selected |
popup |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| If "true", the calendar will be rendered initially as hidden with additional elements for calling as popup Default value is "true" |
popupClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) to be applied to the popup element. This value must be passed through as the "class" attribute on generated markup. |
popupStyle |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| CSS style(s) to be applied to the popup element |
preloadDateRangeBegin |
false
| javax.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())" |
preloadDateRangeEnd |
false
| javax.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())" |
readonly |
false
| javax.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" |
rendered |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| Flag indicating whether or not this component should be rendered (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true. |
required |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| Flag indicating that the user is required to provide a submitted value for this input component. |
requiredMessage |
false
| javax.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. |
resetTimeOnDateSelect |
false
| javax.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" |
showApplyButton |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| If false ApplyButton should not be shown Default value is "false" |
showFooter |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| If false Calendar's footer should not be shown Default value is "true" |
showHeader |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| If false Calendar's header should not be shown Default value is "true" |
showInput |
false
| javax.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" |
showWeekDaysBar |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| If false this bar should not be shown Default value is "true" |
showWeeksBar |
false
| javax.el.ValueExpression
(must evaluate to boolean)
| If false this bar should not be shown Default value is "true" |
style |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| CSS style(s) to be applied when this component is rendered. |
styleClass |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Space-separated list of CSS style class(es) to be applied when this element is rendered. This value must be passed through as the "class" attribute on generated markup. |
tabindex |
false
| javax.el.ValueExpression
(must evaluate to java.lang.String)
| Position of this element in the tabbing order for the current document. This value must be an integer between 0 and 32767. |
timeZone |
false
| javax.el.ValueExpression
(must evaluate to java.util.TimeZone)
| Used for current date calculations Default value is "getDefaultTimeZone()" |
todayControlMode |
false
| javax.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" |
validator |
false
| javax.el.ValueExpression
(must evaluate to javax.faces.el.MethodBinding)
| MethodExpression representing a validator method that will be called during Process Validations to perform correctness checks on the value of this component. The expression must evaluate to a public method that takes FacesContext, UIComponent, and Object parameters, with a return type of void. |
validatorMessage |
false
| javax.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. |
value |
false
| javax.el.ValueExpression
(must evaluate to java.lang.Object)
| The current value of this component. |
valueChangeListener |
false
| javax.el.ValueExpression
(must evaluate to javax.faces.el.MethodBinding)
| MethodExpression representing a value change listener method that will be notified when a new value has been set for this input component. The expression must evaluate to a public method that takes a |
verticalOffset |
false
| javax.el.ValueExpression
(must evaluate to int)
| Sets the vertical offset between popup element and the conjunction point Default value is 0 |
weekDayLabels |
false
| javax.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," |
weekDayLabelsShort |
false
| javax.el.ValueExpression
(must evaluate to java.lang.Object)
| Attribute that allows to customize short names of the weekdays. Should accept list with the weekday's names. |
zindex |
false
| javax.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". |
Output generated by Vdldoc View Declaration Language Documentation Generator.