As the name implies, this is a very customizable calendar used for date/time collection. The properties that this component supports are:
- Name: the name of the component. Please remember that this property must a have a non-empty and unique value within a form.
- Caption: the caption associated with this component.
- Required: this property specifies that the current component must have a value, otherwise the form will not be submitted. In other words, the user must submit a date in the component.
- DateFormat: this property describes how the date will be shown to the user in the front-end part. Please use the folowing table to determine your desired date format.
Mask: Description
d: Day of the month as digits; no leading zero for single-digit days
dd: Day of the month as digits; leading zero for single-digit days.
ddd: Day of the week as a three-letter abbreviation.
dddd: Day of the week as its full name.
m: Month as digits; no leading zero for single-digit months.
mm: Month as digits; leading zero for single-digit months.
mmm: Month as a three-letter abbreviation.
mmmm: Month as its full name.
yy: Year as last two digits; leading zero for years less than 10.
yyyy: Year represented by four digits.
- CalendarLayout: specifies how the calendar should be shown in the front-end. Possible option are:
Flat: the calendar is displayed directly (i.e. no action is required to show the calendar).
Popup: to display the calendar, the user must push a button and the calendar is displayed.
- AdditionalAttributes(!): using this property you can set custom attributes inside the HTML tag. Note that these will be applied to the text box and not the actual popup calendar
- ReadOnly: applicable only for a popup calendar. This option alows the user to edit manually the text box where the date is displayed.
- PopupLabel: applicable only for a popup calendar. Sets the text on the button that when pressed, shows the calendar.
- Description: the description of the component. This will be displayed in the front end, as a textual help for the user. Use this when the Caption of the component is not self-explanatory.
- ValidationMessage: shown when the Required constraint is not met. In other words, if the user doesn't choose date, this message will be displayed and the form will not be submitted.