Skip to main content

Calendar

The Calendar component is a UI tool that displays a graphical Gregorian calendar, enabling date selection and navigation.

Accessibility Support

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

The Calendar 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.

Calendar

ARIA Attributes

AttributeDescription
role="gridcell"Date cells in the calendar body.
aria-selected="true"Indicates the selected date.
aria-disabled="true"Indicates a disabled date.
tabindex="-1"Navigation buttons are not focusable.
aria-labelDescribes the navigation button purpose.
tabindex="-1"Title button is not focusable.
aria-labelDescribes the title button purpose.
tabindex="-1"Today link/button is not focusable.

Keyboard Navigation

TriggerBehavior
Control/Cmd(Mac) + ArrowRightNavigates to the next period.
Control/Cmd(Mac) + ArrowLeftNavigates to the previous period.

UX Behavior

FeatureDescription
Month viewDisplays a grid of days for the current month.
NavigationArrow buttons navigate to the previous and next time period.
View switchingClicking the title switches between day, month, and year views.
Date selectionClicking a date cell selects it.
Range selectionIn range mode, the first and second click define start and end dates.
Disabled datesIndividual dates can be disabled and are skipped during keyboard navigation.

CalendarInfinite

ARIA Attributes

AttributeDescription
role="grid"Specifies the role of the Calendar view container.
aria-labelledbyPointing to the current view label (e.g. March 2022 or 2020-2029).
tabindex="0"Makes the grid focusable.
role="none"Inner table has role removed — content belongs to the grid on the view.

CalendarInfiniteView

ARIA Attributes

AttributeDescription
aria-labelledbyfor the content grid table

CalendarTableRow

ARIA Attributes

AttributeDescription
role="row"Each row in the calendar table.

CalendarTbody

ARIA Attributes

AttributeDescription
role="rowgroup"Groups body rows.

Testing

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

Screen Readers

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

EnvironmentTool
FirefoxNVDA
ChromeJAWS
Microsoft EdgeJAWS

Resources

Feedback