TextEntry

You are viewing an old version (v. 2) of this page.
The latest version is v. 36, last edited on Dec 11, 2014 (view differences | )
<< View previous version | view page history | view next version >>

Overview

The _dateTimeEntry_ component allows you to enter a date and/or a time. You can enter the date/time as text or pick the date/time from an inline or popup calendar. When entering as text, the format is as specified in the pattern attribute.

Getting Started

&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <ace:dateTimeEntry id="cal"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; value="#{datePopup.selectedDate}"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; timeZone="Canada/Mountain"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; pattern="MMM/dd/yyyy"
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; renderAsPopup="true"/>

Attributes

TagLib Documentation
This section covers attributes involved in the typical use-cases for this component. For reference, the complete taglib documentation for this component is available [here|http://www.icefaces.org/docs/v3_latest/ace/tld/ace/dateTimeEntry.html].

*value* is value of the component as a java.util.Date object. Default is current date and time.

*renderAsPopup* determines whether the calendar is displayed inline or as a popup. Default is false, i.e. inline.

The *pattern* attribute  is used to specify the date/time format of the text input field. It also affects whether the time entry sliders appear in the calendar. The pattern characters are as detailed in the [java.text.SimpleDateFormat javadoc|http://download.oracle.com/javase/1.5.0/docs/api/java/text/SimpleDateFormat.html]. (Some uncommon pattern characters may not be translatable to pattern characters for the client side date/time object.) When an hour field is present in the pattern, the time entry sliders will appear.

*timeZone* is used to set the date's time zone. It can be a string or java.util.TimeZone object.

Month/year navigation is by left and right arrow images, one month at a time. To also navigate by month/year drop down lists, set *navigator* to true.

To enter time only, set *timeOnly* to true.

Multiple months can be displayed by specifying the no. of months in *pages*.

Event Listeners

| valueChangeListener | Listener method that will be notified when a new value has been set for this input component. |

Client Behavior Events

| dateSelect | Fired when a date is selected from the calendar (default event). |

JavaScript API

The client side date/time object is exposed through the global variable named by the *widgetVar* attribute, but currently there is no API useful to the user.

Keyboard Support

These keyboard shortcuts work only in a popup calendar without the time component. Some of them may conflict with browser keyboard shortcuts.
|| Keypress || Result ||
| page up/down | previous/next month |
| ctrl+page up/down | previous/next year |
| ctrl+home | current month or open when closed |
| ctrl+left/right | previous/next day |
| ctrl+up/down | previous/next week |
| enter | select the focused day |
| ctrl+end | close and erase the date |
| escape | close the calendar without selection |

Known Issues

Additional Resources

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

© Copyright 2017 ICEsoft Technologies Canada Corp.