Accessibility in Blazor Toolbar Component
10 Oct 20254 minutes to read
The Blazor Toolbar component is designed with WAI-ARIA specifications, applying WAI-ARIA roles, states, and properties, along with keyboard support for assistive devices. WAI-ARIA accessibility support, achieved through attributes like aria-label and aria-orientation, provides information about elements in a document for assistive technology. The component implements keyboard navigation support by following WAI-ARIA practices, and has been tested in major screen readers.
The Blazor Toolbar component adheres to accessibility guidelines and standards, including ADA, Section 508, WCAG 2.2 standards, and WCAG roles commonly used for accessibility evaluation.
The accessibility compliance for the Blazor Toolbar component is outlined below.
| Accessibility Criteria | Compatibility |
|---|---|
| WCAG 2.2 Support |  |
| Section 508 Support | |
| Screen Reader Support |  |
| Right-To-Left Support | |
| Color Contrast | |
| Mobile Device Support | |
| Keyboard Navigation Support | |
| Axe-core Accessibility Validation | |
- All features of the component meet the requirement.
- Some features of the component do not meet the requirement.
- The component does not meet the requirement.WAI-ARIA Attributes
The Blazor Toolbar component is designed considering the WAI-ARIA standard. ARIA Accessibility support ensures the Toolbar is accessible by 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:
| Windows | Mac | Actions |
|---|---|---|
| ← | ← | Focuses the previous element. |
| → | → | Focuses the next element. |
| Enter | Enter | When focused on a ToolBar Item, clicking the key triggers the click of Toolbar element. When popup drop-down icon is focused, the popup opens. |
| Esc(Escape) | Esc | Closes popup. |
| ↓ | ↓ | Focuses the next popup element. |
| ↑ | ↑ | Focuses the previous popup element. |
Ensuring Accessibility
The accessibility levels of the Blazor Toolbar component are ensured through automated testing using the axe-core
software tool.
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.