| Table of Contents |
|---|
...
Date input field. The date can be directly edited here, in the required format. If there is no default date, the input will show a hint text indicating the desired format (for example, dd/mm/yyyy).
Date picker button. A calendar Icon Button which opens the calendar drop-down.
Calendar drop-down, which consists of:
Month calendar, which allows the user to pick a specific date using mouse or keyboard input.
Month and Year drop down menusselectors, which allow the user to directly select a specific month or year.
Left and Right arrows, which allow the user to navigate backward or forward one month at a time.
...
State | Visual | |
|---|---|---|
Regular |  | |
Hover |  | |
Active |  | |
Disabled |  | |
Error |  | |
Warning |  | |
Focused |  | |
Focused, Hover |  | |
Focused, Active |  | |
Focused, Disabled |  |
Calendar
The current day and the selected date are highlighted.
The calendar may contain dates which the user cannot select. Those dates should be disabled.
Days from the previous or next month, seen in the first or last weeks, should be shown using a different colorgreyed out (with the cursor still shown as a hand).
State | Visual | |
|---|---|---|
General |  | |
Regular (x2 in size) |  | |
Hover (x2 in size) |  | |
Active (x2 in size) |  | |
Selected (x2 in size) |  | |
Disabled / Greyed out (x2 in size) |  | In case of greyed out the cursor will still be shown as a hand |
Today (x2 in size) |  |
Interaction
The date can be set either via direct input or by using the controls in the calendar drop-downselectors.
Direct input
The date picker can have an initial value, which the user can edit at any time.
Clicking the date input field will change it to a Text Field, where the user can directly type the required value.
Allow the user to enter dates in loose formats, where possible, which should be automatically corrected when the field loses focus .(e.g. 12.03.20 and 12/3/20 should both be corrected to 12/03/2020).
Calendar drop-down
Clicking on the calendar Icon Button will open the calendar drop-down.
The calendar drop-down will be closed either:
when a date is selected, or
by clicking outside the calendar drop-down.
Clicking the left and right arrows on the calendar moves backwards and forwards between the months.
Validation and Errors
Please refer to Field validation page for more information.
A date field with a warning will have an orange border and a warning icon, as displayed below:
 |
A date field with an error will have a red border and an error icon, as displayed below:
 |
Best practices
Provide a help text which shows the required date format. This will help to prevent input errors.
...