Search results

Accessibility

The Web accessibility defines a way to make web content and web applications more accessible to disabled people. It especially helps the dynamic content change and advanced user interface controls developed with Ajax, HTML, JavaScript, and related technologies.

DateTimePicker provides built-in compliance with the WAI-ARIA specifications. WAI-ARIA supports is achieved through the attributes like aria-expanded, aria-disabled, aria-activedescendant applied to the input element.

To know about the accessibility of Calendar refer to the Calendar’s Accessibility section.

It helps to provide information about the widget for assistive technology to the disabled person in screen reader.

  • Aria-expanded: attributes indicates the state of a collapsible element.

  • Aria-disabled: attribute indicates the disabled state of this DateTimePicker component.

  • Aria-activedescendent: attribute helps in managing the current active child of the DateTimePicker component.

Keyboard Interaction

You can use the following keys to interact with the DateTimePicker. The component implements the keyboard navigation support by following the WAI-ARIA practices.

DateTimePicker supports the below list of shortcut keys.

Input Navigation

Before opening the popup, use the below list of keys to DateTimePicker control the popup element.

Press To do this
Alt + Down Arrow Open the select popup
Alt + Down Arrow + Alt + Down Arrow Toggle between two popups

Calendar Navigation

Use the below list of keys to interact with the Calendar after the DatePicker popup has opened.

Press To do this
Upper Arrow Focus the previous week date.
Down Arrow Focus the next week date.
Left Arrow Focus the previous date.
Right Arrow Focus the next date.
Home Focus the first date in the month.
End Focus the last date in the month.
Page Up Focus the same date in the previous month.
Page Down Focus the same date in the next month.
Enter Select the currently focused date.
Shift + Page Up Focus the same date in the previous year.
Shift + Page Down Focus the same date in the previous year.
Control + Upper Arrow Moves into the inner level of view like month-year, year-decade
Control + Down Arrow Moves out from the depth level view like decade-year, year-month
Control +Home Focus the starting date in the current year.
Control +End Focus the ending date in the current year.

Use the below list of shortcut keys to interact with the TimePicker after the TimePicker Popup has opened.

Press To do this
Upper Arrow Navigate and select the previous item.
Down Arrow Navigate and select the next item.
Left Arrow Move the cursor towards arrow key pressed direction.
Right Arrow Move the cursor towards arrow key pressed direction.
Home Navigate and select the first item.
End Navigate and select the last item.
Enter Select the currently focused item and close the popup.
Alt + Upper Arrow Close the popup.
Alt + Down Arrow Open the popup.
Esc Close the popup.

To focus the DateTimePicker component use the alt+t keys.

tagHelper
@section ControlsSection{
<ejs-datetimepicker id="datetimepicker" placeholder="Select a date and time" ></ejs-datetimepicker>
}

<script>
    document.onkeyup = function (e) {
        if (e.altKey && e.keyCode === 84 /* t */) {
            // press alt+t to focus the component.
            document.getElementById("datetimepicker").ej2_instances[0].element.focus();
        }
    }
</script>