DatePicker

Allows the user to specify a date using a pop-up window that displays a calendar. Waveset displays the field in the form as a calendar icon. When a user clicks on the icon, Waveset opens the calendar in a separate pop-up window.

This component allows a user to enter a date value. Depending on how you set the component properties, the user can enter a date value using select menus, a text field, or a calendar pop-up window. By default, the component renders with a text field and an icon that you click to bring up the calendar pop-up.

Properties include:

• command– Specifies an optional value to submit (for example, Save, Cancel, or Recalculate). Setting this property to Recalculate has the same effect as setting the action property to true, which triggers a refresh (or other) operation. You can trigger a refresh operation by either:

  • Selecting the date with the date widget

    or

  • Changing the date in the text area and tabbing to or clicking another screen area for the refresh to occur.

    See the discussion of the command property in Base Component Class for more information.

• disableTextInput– (Boolean) When set to true, the component renders the date text string without the text input box. Without a text input box, a user cannot edit this field. To change the value of the date string, the user must click the calendar icon and select a date using the pop-up window. Waveset displays the newly selected date as plain text next to the calendar icon.

  If this property is not present, or if set to false, the component renders the input text field normally.

• displayFormatHint– Determines whether the component presents a hint of the expected date format to be entered in the text field. When set to true, Waveset renders a “hint” of the expected date format. The value of the format string is determined by the component’s format property. Waveset does not present a hint under these circumstances:

  • this property is set to false

  • this property is missing

  • multiField property is set to true

  • disableTextInput is true.

  format– Specifies the date format to use for displaying the date. This can be a Java-style date formatting string that uses any of the following formatting characters: y, M, or d. This can also be the value iso, specifying ISO format (yyyy-MM-dd), or the value local, specifying a locale-sensitive format (the Java default for the locale). If omitted, Waveset uses the format “MM/dd/yyyy”.

• multiField– Indicates whether separate input fields should be displayed for each element of the date. If omitted or false, Waveset uses a single text field for input, expecting properly formatted date text.

• value– Specifies the date to be highlighted on the calendar as the current date. Date can be parsed from either a Date object or a String object.

Example

<Field name=’ExpireDate’>
   <Display class=’DatePicker’>
      <Property name=’title’ value=’Set Password Expire  date’/>
      <Property name=’format’= value=’iso’/>
   </Display>
</Field>