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
| Attribute | Description |
|---|---|
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-label | Describes the navigation button purpose. |
tabindex="-1" | Title button is not focusable. |
aria-label | Describes the title button purpose. |
tabindex="-1" | Today link/button is not focusable. |
Keyboard Navigation
| Trigger | Behavior |
|---|---|
Control/Cmd(Mac) + ArrowRight | Navigates to the next period. |
Control/Cmd(Mac) + ArrowLeft | Navigates to the previous period. |
UX Behavior
| Feature | Description |
|---|---|
| Month view | Displays a grid of days for the current month. |
| Navigation | Arrow buttons navigate to the previous and next time period. |
| View switching | Clicking the title switches between day, month, and year views. |
| Date selection | Clicking a date cell selects it. |
| Range selection | In range mode, the first and second click define start and end dates. |
| Disabled dates | Individual dates can be disabled and are skipped during keyboard navigation. |
CalendarInfinite
ARIA Attributes
| Attribute | Description |
|---|---|
role="grid" | Specifies the role of the Calendar view container. |
aria-labelledby | Pointing 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
| Attribute | Description |
|---|---|
aria-labelledby | for the content grid table |
CalendarTableRow
ARIA Attributes
| Attribute | Description |
|---|---|
role="row" | Each row in the calendar table. |
CalendarTbody
ARIA Attributes
| Attribute | Description |
|---|---|
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:
| Environment | Tool |
|---|---|
| Firefox | NVDA |
| Chrome | JAWS |
| Microsoft Edge | JAWS |