Accessibility Support
Out of the box, the Telerik and Kendo UI ToolBar provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.
The ToolBar 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-toolbar | role=toolbar | The component role. |
aria-label or aria-labelledby | Must be supplied on each toolbar only when the application contains more than one toolbars. |
Managing the Focus
The ToolBar is a single tab stop component. All focus movements inside the ToolBar are managed according to the logic of the roving tabindex. When the user navigates through the tabs, the ToolBar focuses either the first tool or the tool that was focused last.
Keyboard Shortcuts
For scenarios where inputs, or comboboxes appear in the ToolBar, you must wrap them in focusable wrappers. To activate the inner component navigation, the user must press Enter. To return the focus to the wrapper and activate again the TolBar navigation, the user must press Esc.
For nested ToolBar components, refer to their respective keyboard navigation specification. The CommandOverflow menu must acquire the same behavior as the DropDownButton.
ToolBar
| Shortcut | Behavior |
|---|---|
Tab | Moves the focus to and from the ToolBar. |
Right Arrow | Moves the focus to the next focusable element in the ToolBar. Focuses the first element if the end of the ToolBar is reached. |
Left Arrow | Moves the focus to the previous focusable element in the ToolBar. Focuses the last element if the beginning of the ToolBar is reached. |
Home | Moves the focus to the first focusable element. |
End | Moves the focus to the last focusable element. |
Enter | Clicks the currently active button or changes the state of the currently active toggleable button. If the active tool is represented by an <input> element, enters the inner navigation mode of the tool. |
Esc | If the active tool is represented by an <input> element and its inner navigation is active, deactivates the tool navigation and returns the focus to the ToolBar. |
Alt + Down Arrow | Opens the currently active SplitButton, DropDownButton, or CommandOverflow. |
Alt + Up Arrow | Closes the currently active SplitButton, DropDownButton, or CommandOverflow. |
Testing
The ToolBar has been extensively tested automatically with axe-core and manually with the most popular screen readers.
Screen Readers
The ToolBar has been tested with the following screen readers and browsers combinations:
| Environment | Tool |
|---|---|
| Firefox | NVDA |
| Chrome | JAWS |
| Microsoft Edge | JAWS |
