Skip to main content

DateTimePicker

The DateTimePicker enables users to select both date and time from a single control, making it ideal for precise scheduling.

Accessibility Support

Out of the box, the Telerik and Kendo UI Datetimepicker provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.

The Datetimepicker is compliant with the Web Content Accessibility Guidelines (WCAG) 2.2 standards and Section 508 requirements, follows the Web Accessibility Initiative - Accessible Rich Internet Applications (WAI-ARIA) best practices for implementing the keyboard navigation and provides options for managing its focus and is tested against the most popular screen readers.

DateTimeContainer

ARIA Attributes

AttributeDescription
aria-invalid="true"Rendered only when the picker is in form and announces invalid state.
aria-disabled="true"Rendered only when the picker is disabled.

DateTimePicker

ARIA Attributes

AttributeDescription
role="combobox"The input element follows the combobox specification.
aria-haspopup="dialog"Indicates the component has a Dialog Popup.
aria-expanded="true"|\"false"Announces whether the Popup is visible or not.
aria-controlsPoints to the popup element containing the calendar or time selector.
aria-activedescendantPoints to the focused item in the Calendar or Time Popup.
aria-label|aria-labelledbyThe input needs an accessible name.
tabindex="-1"Button element must not be focusable.
aria-labelThe button needs an accessible name.
aria-disabledRendered only when the picker is disabled.

Keyboard Navigation

TriggerBehavior
EscapeDiscards the selection and closes the popup.
EnterEnters in time edit if calendar is the target. Otherwise, accepts the selected time and closes the popup.
Alt/Opt(Mac) + ArrowDownOpens the dropdown and moves the focus to the displayed calendar.
Alt/Opt(Mac) + ArrowUpCloses the dropdown and moves the focus to the input element.

UX Behavior

FeatureDescription
Combined pickerA single popup contains both a date calendar and a time selector.
Tab switchingThe popup header switches between the date and time views.
Direct inputDate and time can also be typed directly into the input.
Disabled stateWhen disabled, the input and popup are non-interactive.

Testing

The Datetimepicker has been extensively tested automatically with axe-core and manually with the most popular screen readers.

Screen Readers

The Datetimepicker has been tested with the following screen readers and browsers combinations:

EnvironmentTool
FirefoxNVDA
ChromeJAWS
Microsoft EdgeJAWS

Resources

Feedback