Toolbar

ToolBars are UI elements wrapping groups of related actions or commands of equal importance.

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.

SelectorAttributeUsage
.k-toolbarrole=toolbarThe component role.
aria-label or aria-labelledbyMust 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

ShortcutBehavior
TabMoves the focus to and from the ToolBar.
Right ArrowMoves the focus to the next focusable element in the ToolBar. Focuses the first element if the end of the ToolBar is reached.
Left ArrowMoves the focus to the previous focusable element in the ToolBar. Focuses the last element if the beginning of the ToolBar is reached.
HomeMoves the focus to the first focusable element.
EndMoves the focus to the last focusable element.
EnterClicks 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.
EscIf 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 ArrowOpens the currently active SplitButton, DropDownButton, or CommandOverflow.
Alt + Up ArrowCloses 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:

EnvironmentTool
FirefoxNVDA
ChromeJAWS
Microsoft EdgeJAWS

Resources

Feedback