| AppliBuilder
User Documentation |
This widget makes it easy for a user enter a date, by providing a drop-down calendar along with a text input field. The user can click on any date in the calendar to select it. The input field is populated with the date in the RFC 3339 format (currently, timezone information is removed).
Example:
30 April, 2006 is available as the string: 2006-04-30
i.e., YYYY-MM-DD.
To get the current value of the text field in your scripts, use the getInputValue(element_name) global function to access the value from your scripts.
When the user clicks on a date in the displayed calendar, the onSetDate
event is fired. A custom handler function can be invoked in the onSetDate
property in the Events tab of the properties form.
An example handler function:
function(rfcDate){ alert(rfcDate); }
The selected date is passed as the first parameter to the handler function in the RFC 3339 format (currently, timezone information is removed).
Note: Currently the DateInputWidget does not provide for
customization of the date format, but that will be done soon.
Note: This widget may not always render properly in the design
view in Internet Explorer. It might even crash Internet Explorer in the
design mode.
DateInputWidget is based on the DatePicker provided by the Dojo Toolkit.
The CSS styles for the element can be setup via the styles property tab.
Click on the date input icon to add this widget to your page, and double click on the widget to set properties.
| ©
2006 Applibase, Inc. |