Skip to main content

Dialog

Dialogs are versatile UI elements that display information and prompt users to take actions by interacting with a modal window.

Accessibility Support

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

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

Dialog

ARIA Attributes

AttributeDescription
role="dialog"|\"alertdialog"Announces the dialog or alertdialog role of the component.
aria-labelledbyAssociate the title of the dialog.
aria-describedbyAssociate the dialog content to the wrap element.
aria-modal="true"Announces that the dialog is modal. Attribute is added only when the dialog is modal.

Keyboard Navigation

TriggerBehavior
TabFocus is moved between the elements in the dialog and is trapped into the component.
EscapeCloses the dialog. When the dialog is modal, the focus should be returned to the element that triggered the open.

UX Behavior

FeatureDescription
Modal overlayRenders a backdrop that blocks interaction with the underlying page.
Close buttonAn optional × button in the title bar dismisses the dialog.
Action buttonsFooter buttons let the user confirm or cancel the operation.
DraggableThe dialog can be repositioned by dragging its title bar.
ResizableThe dialog can be resized by dragging its edges or corners.

Testing

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

Screen Readers

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

EnvironmentTool
FirefoxNVDA
ChromeJAWS
Microsoft EdgeJAWS

Resources

Feedback