This widget is commonly used to select a date value as an input on a form. The Calendar Picker builder does the following operations.
- Generates the calendar widget.
- Locates the widget on a named tag on the page.
- Fires an event.
This builder inserts a button (either a text button or an image button) and a text input on a page. Clicking the button pops up a calendar, and the date that is selected in the calendar is inserted in the text input. When the date is selected, the builder fires an onchange
The Calendar Picker builder can format the selected date using a restricted set of the standard Java™ Date formats. The allowable characters are y
, and d
. Any other character is considered a date separator.
Placement of two Calendar Picker builders on the same page
You can place two Calendar Picker builders on the same page to enable a user to select a range of dates. This is useful when you want to retrieve data over a varying lengths of time, for example, days, weeks, or months.
A placement problem occurs if the second calendar is located using Relative to Named Tag
, and placement is specified After
the first calendar tag. The button that is associated with the second calendar is displayed before the first calendar. To avoid this issue, use a Page Location
input other than Relative to Named Tag
to specify the location of the second calendar picker.
Parent topic: Builder help
About using the builder call editor
Style Sheet builder
Locating control builder calls on pages