Accessibility in EJ2 TypeScript Toolbar control
24 Jan 20245 minutes to read
The JavaScript Toolbar control 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 control implements keyboard navigation support by following the WAI-ARIA practices, and has been tested in major screen readers.
The accessibility compliance for the Toolbar control 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 | |
| Accessibility Checker Validation | |
| Axe-core Accessibility Validation | |
- All features of the control meet the requirement.
- Some features of the control do not meet the requirement.
- The control does not meet the requirement.ARIA attributes
Toolbar control 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.
| Property | Functionalities |
|---|---|
| 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
| Key | Description |
|---|---|
| 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. |
| Home | Moves focus to the first Toolbar. |
| End | Moves focus to the last Toolbar. |
| Tab | To Move focus through the interactive elements. |
| Shift + Tab | To Move focus through the interactive elements. |
Ensuring accessibility
The Toolbar control accessibility levels are ensured through an accessibility-checker and axe-core software tools during automated testing.
The accessibility compliance of the Toolbar control is shown in the following sample. Open the sample in a new window to evaluate the accessibility of the Toolbar control with accessibility tools.