Attributes |
Name | Required | Request-time | Type | Description |
binding | no | false | javax.el.ValueExpression | Using an EL expression, bind the component reference to a bean property, so that the component may be accessed in the bean. |
buttonText | no | false | java.lang.String | The text to display on the trigger button. Use in conjunction with the showOn option set to "button" or "both". Default = "". |
converter | no | false | javax.faces.convert.Converter | Converter is an interface describing a Java class that can perform Object-to-String and String-to-Object conversions between model data objects and a String representation of those objects that is suitable for rendering. |
converterMessage | no | false | java.lang.String | If present, will be used as the text of the converter message, replacing any message that comes from the converter. |
disableHoverStyling | no | false | boolean | Set to true to disable hover styling to improve performance. Default = 'false'. |
disabled | no | false | boolean | If true then this date time entry will be disabled and can not be entered. Default = 'false'. |
effect | no | false | java.lang.String | Name of the animation used to show/hide the calendar. Use "show", "slideDown", "fadeIn", any of the show/hide jQuery UI effects, or "" for no animation. Default = 'show'. |
effectDuration | no | false | java.lang.String | Control the speed at which the calendar appears, it may be a time in milliseconds or a string representing one of the three predefined speeds ("slow", "normal", "fast"). Default = 'normal'. |
id | no | false | 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 | no | false | boolean | A flag indicating that conversion and validation of this component's value should occur during Apply Request Values phase instead of Process Validations phase. Default = 'false'. |
indicatorPosition | no | false | java.lang.String | Position of input-required or input-optional indicator relative to input field or label. Supported values are "left/right/top/bottom/labelLeft/labelRight/none". Default is "labelRight" if labelPosition is "inField", "right" otherwise. |
label | no | false | java.lang.String | A localized user presentable name for this component. |
labelPosition | no | false | java.lang.String | Position of label relative to input field. Supported values are "left/right/top/bottom/inField/none". Default is "none". |
leftMonthOffset | no | false | int | Zero-based offset indicating which month should be displayed in the leftmost position. Default = '0'. |
lenientParsing | no | false | boolean | With lenient parsing, the Java date parser may use heuristics to interpret inputs that do not precisely match this date's format. With strict parsing, inputs must match this date's format. Ignored if the converter attribute is used to do format conversion. Default = 'true'. |
locale | no | false | java.lang.Object | Locale to be used for labels and conversion. Locale string or java.util.Locale object. Default is locale of view root. |
maxHour | no | false | int | Set the hour range. Default = '23'. |
maxMinute | no | false | int | Set the minute range. Default = '59'. |
maxSecond | no | false | int | Set the second range. Default = '59'. |
maxdate | no | false | java.lang.Object | Set a maximum selectable date. Date string or java.util.Date object. Default is no limit. |
maxlength | no | false | int | The maximum number of characters that may be entered in this field. |
minHour | no | false | int | Set the hour range. Default = '0'. |
minMinute | no | false | int | Set the minute range. Default = '0'. |
minSecond | no | false | int | Set the second range. Default = '0'. |
mindate | no | false | java.lang.Object | Set a minimum selectable date. Date string or java.util.Date object. Default is no limit. |
navigator | no | false | boolean | Enables month/year navigator. |
optionalIndicator | no | false | java.lang.String | Indicator indicating that the user is NOT required to provide a submitted value for this input component. |
pages | no | false | int | Enables multiple page rendering. Default = '1'. |
pattern | no | false | java.lang.String | DateFormat pattern for localization. See the DateTimeEntry Wiki Documentation for limitations. Ignored if the converter attribute is used to do format conversion. Default = 'MM/dd/yyyy'. |
popupIcon | no | false | java.lang.String | The URL for the popup button image. Default is the file "META-INF/resources/icefaces.ace/datetimeentry/calendar_icon.png" in the components jar. showOn attribute must be set to "button" or "both". |
popupIconOnly | no | false | boolean | When enabled, popup icon is rendered without it appearing on a button. Default: "false". |
readOnlyInputText | no | false | boolean | Makes input text of a popup calendar readonly. |
readonly | no | false | boolean | If true then this date time entry will be read-only and can not be entered. |
renderAsPopup | no | false | boolean | Whether to render the calendar inline or as a popup. Default = 'false'. |
rendered | no | false | boolean | Return true if this component (and its children) should be rendered during the Render Response phase of the request processing lifecycle. Default = 'true'. |
required | no | false | boolean | A flag indicating whether the user required to provide a non-empty submitted value for this component. Default = 'false'. |
requiredIndicator | no | false | java.lang.String | Indicator indicating that the user is required to provide a submitted value for this input component. |
requiredMessage | no | false | java.lang.String | If present, will be used as the text of the validation message for the "required" facility, if the "required" facility is used. |
selectOtherMonths | no | false | boolean | Enables selection of days belonging to other months. |
showButtonPanel | no | false | java.lang.Boolean | Whether to show the panel containing today button and close button for popup. Default is false without time component and true with time component. |
showOn | no | false | java.lang.String | Have the calendar appear automatically when the field receives focus ("focus"), appear only when a button (specified by popupIcon attribute) is clicked ("button"), or appear when either event takes place ("both"). Default = 'focus'. |
showOtherMonths | no | false | boolean | Displays days belonging to other months. |
showWeek | no | false | boolean | Displays the week number next to each week. |
singleSubmit | no | false | boolean | When singleSubmit is true, changing the value of this component will submit and execute this component only (equivalent to <f:ajax execute="@this" render="@all">). When singleSubmit is false, no submit will occur. <ace:ajax> submit events have precedence over singleSubmit. Default = 'false'. |
size | no | false | int | The number of characters used to determine the width of the input field in a popup calendar. Default is the maximum possible size of a date formatted by the date pattern. |
stepHour | no | false | int | Increment/decrement steps when hour slider is dragged. Default = '1'. |
stepMinute | no | false | int | Increment/decrement steps when minute slider is dragged. Default = '1'. |
stepSecond | no | false | int | Increment/decrement steps when second slider is dragged. Default = '1'. |
style | no | false | java.lang.String | style will be rendered on a root element of this component |
styleClass | no | false | java.lang.String | style class will be rendered on a root element of this component |
tabindex | no | false | java.lang.String | Position of the text field in the tabbing order for the current page. This value must be an integer between 0 and 32767. |
timeOnly | no | false | boolean | Specifies whether to display/input time only. Default = 'false'. |
timeZone | no | false | java.lang.Object | String or a java.util.TimeZone instance to specify the timezone used for date conversion, defaults to TimeZone.getDefault() |
validator | no | false | javax.el.MethodExpression | 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 | no | false | java.lang.String | If present, will be used as the text of the validator message, replacing any message that comes from the validator. |
value | no | false | java.lang.Object | The current value of the simple component. The value to be rendered. |
valueChangeListener | no | false | javax.el.MethodExpression | 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 ValueChangeEvent parameter, with a return type of void, or to a public method that takes no arguments with a return type of void. In the latter case, the method has no way of easily knowing what the new value is, but this can be useful in cases where a notification is needed that "this value changed". |
widgetVar | no | false | java.lang.String | Name of the client side widget. |
yearRange | no | false | java.lang.String | Control the range of years displayed in the year drop-down: either relative to today's year (-nn:+nn), relative to the currently selected year (c-nn:c+nn), absolute (nnnn:nnnn), or combinations of these formats (nnnn:-nn). Default = 'c-10:c+10'. |