The DateNavigator UI element enables users to display and enter dates. Its features include the ability to navigate in a calendar and choose a day, month, year, or range of dates. Primarily, this element should be used to help users to input dates in an appropriate format.
You can use the DateNavigatorLegend and the DateNavigatorMarking Element to add a legend for the description of selected data to the DateNavigator UI element. This enables you to provide the user with information on specific data that is assigned to a category. For example, events in the calendar can be highlighted in a different color and each event can be described with agenda, time, and location.
Example of the Display
|
If the tooltip property has not been set, the property accessibilityDescription is checked during the design time to ensure Accessibility.
The property accessibilityDescription applies to the entire DateNavigator and is read out by the screen reader when the DateNavigator itself is focused on. The tooltip is displayed for each day, except if this day has a marking and this contains a filled tooltip.
Runtime Class |
CL_WD_DATE_NAVIGATOR |
Properties in the View Designer
Name |
Type |
Initial Value |
Bindable |
ID |
STRING |
(automatic) |
No |
Text |
|
Yes |
|
WDY_BOOLEAN |
true |
Yes |
|
WDUI_DAY_OF_WEEK |
auto |
Yes |
|
D |
|
Yes |
|
D |
|
Yes |
|
STRING |
|
Yes |
|
I |
1 |
Yes |
|
I |
3 |
Yes |
|
WDUI_DATE_SELECTION_MODE |
single |
Yes |
|
D |
|
Yes |
|
Text |
|
Yes |
|
WDUI_VISIBILITY |
visible |
Yes |
Aggregations in the View Designer
Name |
Cardinality |
Type |
0..1 |
||
0..1 |
Events in the View Designer
Name |
Further properties that can be inherited are defined in the associated higher-level class. The associated interface elements are:
For dynamic programming the same properties, events, and aggregations are provided in the View Designer. Bear in mind the different spellings.
Dynamic Programming of Properties
View Designer Name |
Runtime Name |
Type |
ACCESSIBILITY_DESCR |
WDY_MD_TRANSLATABLE_TEXT |
|
ENABLED |
WDY_BOOLEAN |
|
FIRST_DAY_OF_WEEK |
WDUI_DAY_OF_WEEK |
|
firstDayOfWeek: auto |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-AUTO |
|
firstDayOfWeek: friday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-FRIDAY |
|
firstDayOfWeek: monday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-MONDAY |
|
firstDayOfWeek: saturday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-SATURDAY |
|
firstDayOfWeek: sunday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-SUNDAY |
|
firstDayOfWeek: thursday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-THURSDAY |
|
firstDayOfWeek: tuesday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-TUESDAY |
|
firstDayOfWeek: wednesday |
CL_WD_DATE_NAVIGATOR=>E_FIRST_DAY_OF_WEEK-WEDNESDAY |
|
FIRST_SELECTED_DATE |
D |
|
LAST_SELECTED_DATE |
D |
|
LEGEND_ID |
STRING |
|
MONTHS_PER_COLUMN |
I |
|
MONTHS_PER_ROW |
I |
|
SELECTION_MODE |
WDUI_DATE_SELECTION_MODE |
|
selectionMode: none |
CL_WD_DATE_NAVIGATOR=>E_SELECTION_MODE-NONE |
|
selectionMode: range |
CL_WD_DATE_NAVIGATOR=>E_SELECTION_MODE-RANGE |
|
selectionMode: single |
CL_WD_DATE_NAVIGATOR=>E_SELECTION_MODE-SINGLE |
|
STARTS_WITH |
D |
|
TOOLTIP |
WDY_MD_TRANSLATABLE_TEXT |
|
VISIBLE |
WDUI_VISIBILITY |
|
visible: none |
CL_WD_DATE_NAVIGATOR=>E_VISIBLE-NONE |
|
visible: visible |
CL_WD_DATE_NAVIGATOR=>E_VISIBLE-VISIBLE |
Dynamic Programming of Events
View Designer Name |
Runtime Name |
ON_DAY_SELECT |
|
ON_MONTH_SELECT |
|
ON_START_DATE_CHANGED |
|
ON_WEEK_SELECT |
Dynamic Programming of Aggregations
View Designer Name |
Runtime Name |
Cardinality |
LEGEND |
0..1 |
|
MARKING |
0..1 |
You can find examples of this interface element in the system in the Web Dynpro application WDR_TEST_UI_ELEMENTS, and in the component WDR_TEST_EVENTS in the View DateNavigator.