Accessibility in Blazor Toolbar Component

10 Jun 20244 minutes to read

The Blazor Toolbar component has been designed, keeping in mind the WAI-ARIA specifications, and applying the WAI-ARIA roles, states and properties along with keyboard support for people who use assistive devices. WAI-ARIA accessibility support is achieved through attributes like aria-label and aria-orientation, It provides information about elements in a document for assistive technology. The component implements keyboard navigation support by following the WAI-ARIA practices, and has been tested in major screen readers.

The Blazor Toolbar component followed the accessibility guidelines and standards, including ADA, Section 508, WCAG 2.2 standards, and WCAG roles that are commonly used to evaluate accessibility.

The accessibility compliance for the Blazor Toolbar component is outlined below.

Accessibility Criteria Compatibility
WCAG 2.2 Support Yes
Section 508 Support Yes
Screen Reader Support Yes
Right-To-Left Support Yes
Color Contrast Yes
Mobile Device Support Yes
Keyboard Navigation Support Yes
Axe-core Accessibility Validation Yes
Yes - All features of the component meet the requirement.
Partial - Some features of the component do not meet the requirement.
No - The component does not meet the requirement.

WAI-ARIA attributes

Blazor Toolbar component is designed by considering WAI-ARIA standard. Toolbar is supported with ARIA Accessibility which is accessible by on-screen readers, and other assistive technology devices.

The following list of attributes are added in the Toolbar.

Attributes Purpose
role=”toolbar” Attribute is set to the ToolBar element describes the actual role of the element.
aria-orientation Attribute is set to the ToolBar element to indicates the ToolBar orientation. Default value is horizontal.
aria-label Attribute is set to ToolBar element describes the purpose of the set of toolbar.
aria-expanded Attribute is set to the ToolBar Popup element to indicates the expanded state of the popup.
aria-haspopup Attribute is set to the popup element to indicates the popup mode of the Toolbar. Default value is false. When popup mode is enabled, attribute value has to be changed to true.
aria-disabled Attribute set to the ToolBar element to indicates the disabled state of the ToolBar.

Keyboard interaction

Keyboard navigation is enabled, by default. Possible keys are:

Keyboard shortcuts Actions
Left Focuses the previous element.
Right Focuses the next element.
Enter When focused on a ToolBar command, clicking the key triggers the click of Toolbar element. When popup drop-down icon is focused, the popup opens.
Esc(Escape) Closes popup.
Down Focuses the next popup element.
Up Focuses the previous popup element.

Ensuring accessibility

The Blazor Toolbar component’s accessibility levels are ensured through an axe-core software tool during automated testing.

The accessibility compliance of the Toolbar component is shown in the following sample. Open the sample in a new window to evaluate the accessibility of the Toolbar component with accessibility tools.

See also