Window

The Window component provides a movable and resizable container for displaying temporary or additional content in a separate window on the screen.

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.

SelectorAttributeUsage
.k-window:not(.k-dialog)role=dialogAnnounces the dialog role of the component.
aria-labelledby=.k-window-title idAssociate the title of the dialog.
.k-overlay + .k-windowaria-modal=trueAnnounces 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 Tab key
  • Tab Key Trap is implemented for modal windows

Keyboard Shortcuts

ShortcutBehavior
Alt/Opt(Mac) + DownArrowMinimizes or restores the state, if the focused element is the window
Alt/Opt(Mac) + UpArrowMaximizes or restores the state, if the focused element is the window
Arrow KeysMove the window to the respective direction (UP
Ctrl/Cmd(Mac) + UpArrowDecreases the height of the window triggering the resizing capabilities. Applicable only when the component is resizable.
Ctrl/Cmd(Mac) + DownArrowIncreases the height of the window triggering the resizing capabilities. Applicable only when the component is resizable.
Ctrl/Cmd(Mac) + LeftArrowDecreases the width of the window triggering the resizing capabilities. Applicable only when the component is resizable.
Ctrl/Cmd(Mac) + RightArrowIncreases the width of the window triggering the resizing capabilities. Applicable only when the component is resizable.
EscapeCloses 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:

EnvironmentTool
FirefoxNVDA
ChromeJAWS
Microsoft EdgeJAWS

Resources