Accessibility Support
Out of the box, the Telerik and Kendo UI Window provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.
The Window 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 for its component role, provides options for managing its focus and is tested against the most popular screen readers.
WAI-ARIA
This section lists the selectors, attributes, and behavior patterns supported by the component and its composite elements, if any.
| Selector | Attribute | Usage |
|---|---|---|
.k-window:not(.k-dialog) | role=dialog | Announces the dialog role of the component. |
aria-labelledby=.k-window-title id | Associate the title of the dialog. | |
.k-overlay + .k-window | aria-modal=true | Announces that the dialog is modal. Attribute is added only when the dialog is modal. |
Action buttons follow the Button specification.
Managing the Focus
- Initial focus - When opened, the Window should be focused.
- Action buttons are accessed with
Tabkey - Tab Key Trap is implemented for modal windows
Keyboard Shortcuts
| Shortcut | Behavior |
|---|---|
Alt/Opt(Mac) + DownArrow | Minimizes or restores the state, if the focused element is the window |
Alt/Opt(Mac) + UpArrow | Maximizes or restores the state, if the focused element is the window |
Arrow Keys | Move the window to the respective direction (UP |
Ctrl/Cmd(Mac) + UpArrow | Decreases the height of the window triggering the resizing capabilities. Applicable only when the component is resizable. |
Ctrl/Cmd(Mac) + DownArrow | Increases the height of the window triggering the resizing capabilities. Applicable only when the component is resizable. |
Ctrl/Cmd(Mac) + LeftArrow | Decreases the width of the window triggering the resizing capabilities. Applicable only when the component is resizable. |
Ctrl/Cmd(Mac) + RightArrow | Increases the width of the window triggering the resizing capabilities. Applicable only when the component is resizable. |
Escape | Closes the window. When the window is modal, the focus should be returned to the element that triggered the open. |
Testing
The Window has been extensively tested automatically with axe-core and manually with the most popular screen readers.
Screen Readers
The Window has been tested with the following screen readers and browsers combinations:
| Environment | Tool |
|---|---|
| Firefox | NVDA |
| Chrome | JAWS |
| Microsoft Edge | JAWS |
