o
Tag dateChooser


The DateChooser component allows the user to enter a date either by typing it in the text field or selecting it from the calendar that appears when clicking a button next to text field. The selected date is displayed in the text field in the specified format.


Tag Information
Tag Classorg.openfaces.taglib.jsp.input.DateChooserJspTag
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredBinding TypeELDefaultDescription
accesskeyfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullAn access key for the DateChooser component.
bindingfalsejavax.el.ValueExpression
(must evaluate to org.openfaces.component.input.DateChooser)
onlynullA value-binding expression that associates the DateChooser component with a backing bean property.
buttonClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the button that opens the pop-up calendar
buttonImageUrlfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullURL of the image file that is used to render the button that opens the pop-up calendar.
buttonStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the button that opens the pop-up calendar.
calendarClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the pop-up calendar.
calendarStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the pop-up calendar.
dateFormatfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"medium"This attribute defines which of the predefined date formats for a given locale should be used.
Available values are:
"short" — the same as "SHORT" format in the java.text.DateFormat
"medium" — the same as "MEDIUM" format in the java.text.DateFormat
"long" — the same as "LONG" format in the java.text.DateFormat
"full" — the same as "FULL" format in the java.text.DateFormat
dayClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for all dates.
daysHeaderClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the row displaying weekday names.
daysHeaderStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the row displaying weekday names.
dayStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for all dates.
disabledfalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseA flag that enables or disables the component.
disabledButtonClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the button in the disabled state.
disabledButtonImageUrlfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullURL of the image file that is used to render the button that opens the pop-up calendar in the disabled state.
disabledButtonStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the button in the disabled state.
disabledClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the entire DateChooser component in the disabled state.
disabledFieldClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the text field in the disabled state.
disabledFieldStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the text field in the disabled state.
disabledStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the entire DateChooser component in the disabled state.
fieldClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the text field.
fieldStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the text field.
firstDayOfWeekfalsejavax.el.ValueExpression
(must evaluate to int)
true1The first day of the week which is used by the pop-up calendar to arrange days by weeks. It can take the values from "1" (Sunday) to "7" (Monday).
focusablefalsejavax.el.ValueExpression
(must evaluate to boolean)
truetrueSpecifies whether this component can have input focus for keyboard control.
focusedClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name of the DateChooser component when it is focused.
focusedStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style of the DateChooser component when it is focused.
footerClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the footer of the pop-up calendar.
footerStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the footer of the pop-up calendsar.
headerClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the header of the pop-up calendar.
headerStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the header of the pop-up calendar.
idfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
falsenullThe component identifier.
immediatefalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseA flag that indicates whether or not the valueChangeListener should be executed immediately (during the Apply Request Values phase of the request processing lifecycle instead of Process Validations phase) and the component's input should be converted and validated immediately (during the Apply Request Values phase of the request processing lifecycle instead of the Process Validations phase).
inactiveMonthDayClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the dates of a non-current month.
inactiveMonthDayStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the dates of a non-current month.
keepTimefalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseA flag that indicates whether or not to keep time portion of the bound date value.
labelfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA localized user presentable name for this component. Used when constructing validation messages for this component in the same way as for the standard component.
localefalsejavax.el.ValueExpression
(must evaluate to java.util.Locale)
trueclient's localeThe locale used by DateChooser component. You can specify the "locale" attribute as a value-binding expression or as a String in "ll_CC_vv" format, where:
ll stands for the language - lowercase two-letter ISO-639 code.
CC stands for the country - uppercase two-letter ISO-3166 code (optional).
vv stands for the variant - vendor and browser specific code (optional).
noneTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullThe label for the "None" button in the pop-up calendar.
onblurfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the DateChooser loses focus.
onchangefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when the user changes a date.
onclickfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when the user clicks the left mouse button over the DateChooser.
oncontextmenufalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user presses right mouse button over the component (or performs the other context menu invocation action depending on the platform).
ondblclickfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when the user double-clicks the left mouse button over the DateChooser.
onfocusfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the DateChooser receives focus.
onkeydownfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user presses a key over the DateChooser.
onkeypressfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed on the client when the user presses and releases a key over the DateChooser.
onkeyupfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user releases a key over the DateChooser.
onmousedownfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user clicks over the DateChooser with either mouse button.
onmousemovefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user moves the mouse pointer over the DateChooser.
onmouseoutfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user moves the mouse pointer away from the DateChooser.
onmouseoverfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user moves the mouse pointer onto the DateChooser.
onmouseupfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullJavaScript code that should be executed when the user releases a mouse button over the DateChooser.
patternfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
falsenullThe date format with the pattern similar to that in the java.text.SimpleDateFormat class.
pressedButtonClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the button in the pressed state.
pressedButtonStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the button in the pressed state.
promptTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullThis prompt text will be shown when value of component is empty.
promptTextClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the prompt text.
promptTextStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the prompt text.
renderedfalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseA flag that indicates whether or not the component is visible.
requiredfalsejavax.el.ValueExpression
(must evaluate to boolean)
truefalseA flag that indicates whether or not the DateChooser requires a value.
rolloverButtonClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA class for the button in the rollover state that opens the pop-up calendar.
rolloverButtonStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the button in the rollover state that opens the pop-up calendar.
rolloverClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA class for the component in the rollover state.
rolloverDayClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for all dates in the rollover state.
rolloverDayStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for all dates in the rollover state.
rolloverFieldClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA class for the text field in the rollover state.
rolloverFieldStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the text field in the rollover state.
rolloverInactiveMonthDayClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the dates of a non-current month in the rollover state.
rolloverInactiveMonthDayStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the dates of a non-current month in the rollover state.
rolloverSelectedDayClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for a selected date in the rollover state.
rolloverSelectedDayStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for a selected date in the rollover state.
rolloverStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the component in the rollover state.
rolloverTodayClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for today's date in the rollover state.
rolloverTodayStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for today's date in the rollover state.
rolloverWeekendDayClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the weekend dates in the rollover state.
rolloverWeekendDayStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the weekend dates in the rollover state.
selectedDayClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for a selected date.
selectedDayStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for a selected date.
showFooterfalsejavax.el.ValueExpression
(must evaluate to boolean)
truetrueA flag that indicates whether or not to show the footer of the pop-up calendar.
stylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the entire DateChooser component.
styleClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the entire DateChooser component.
tabindexfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullPosition of the component in the focus transition chain for the current document.
timeZonefalsejavax.el.ValueExpression
(must evaluate to java.util.TimeZone)
trueThe server's default time zoneTime zone in which to interpret any time information in the date String. Value must be either a VB expression that evaluates to a java.util.TimeZone instance, or a String that is a timezone ID as described in the javadocs for java.util.TimeZone.getTimeZone().
titlefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullAn advisory title for the text field of the DateChooser component.
todayClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for today's date.
todayStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for today's date.
todayTextfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
true"Today"The label for the "Today" button in the pop-up calendar.
typingAllowedfalsejavax.el.ValueExpression
(must evaluate to boolean)
truetrueAllows disabling typing in the date with keyboard when this attribute is set to false.
validatorfalsejavax.el.MethodExpression
(signature must match void validate(javax.faces.context.FacesContext, javax.faces.component.UIComponent, java.lang.Object))
onlynullA MethodBinding that should point to the method in the backing bean that is called to validate the DateChooser's value.
valuefalsejavax.el.ValueExpression
(must evaluate to java.util.Date)
truenullThe current value of the DateChooser component component that is displayed in the text field.
valueChangeListenerfalsejavax.el.MethodExpression
(signature must match void valueChange(javax.faces.event.ValueChangeEvent))
onlynullA MethodBinding that should point to the method that accepts a ValueChangeEvent. If the value of the DateChooser changes, this method is executed.
weekendDayClassfalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA CSS class name for the weekend dates.
weekendDayStylefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
truenullA style for the weekend dates.

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.