Accessibility Support
Out of the box, the Telerik and Kendo UI ExpansionPanel provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.
The ExpansionPanel 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.
ExpansionPanel Wrapping Element
| Selector | Attribute | Usage |
|---|---|---|
.k-expander-header | role=button | Sets the proper role for the ExpansionPanel component. |
aria-controls=.k-expander-content-wrapper id | Points to the controlled element based on the given id. | |
aria-expanded=true/false | Indicates the expanded state of the ExpansionPanel. | |
tabindex=0 | The element should be focusable. | |
.k-disabled .k-expander-header | aria-disabled=true/false | The attribute is rendered only when the ExpansionPanel is disabled. |
Managing the Focus
The ExpansionPanel is a single-tab-stop component. By default only its header is focusable and interactive. If there are focusable elements within the component's content, they remain in the page tab sequence.
Keyboard Shortcuts
| Shortcut | Behavior |
|---|---|
Enter | Expands and collapses the focused ExpansionPanel. |
Space | Expands and collapses the focused ExpansionPanel. |
Testing
The ExpansionPanel has been extensively tested automatically with axe-core and manually with the most popular screen readers.
Screen Readers
The ExpansionPanel has been tested with the following screen readers and browsers combinations:
| Environment | Tool |
|---|---|
| Firefox | NVDA |
| Chrome | JAWS |
| Microsoft Edge | JAWS |
