Accessibility in Blazor Chart Component
5 May 20256 minutes to read
The Blazor Chart 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 Chart 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
WAI-ARIA(Accessibility Initiative - Accessible Rich Internet Applications) defines a way to increase the accessibility of web pages, dynamic content, and user interface components developed with AJAX, HTML, JavaScript, and related technologies. ARIA provides additional semantics to describe the role, state, and functionality of web components.
| Element | Default description |
|---|---|
| Datalabel | Reads the Point y value. |
| Legend | Click to show or hide the series. |
| Axis Title | Reads the axis title. |
| Chart Title | Reads the chart title. |
| Series Points | Reads the Point x: Point y value. |
The Blazor Chart component followed the WAI-ARIA patterns to meet the accessibility. The following ARIA attributes are used in the Blazor Chart component:
- img (role)
- button (role)
- region (role)
- aria-label (attribute)
- aria-hidden (attribute)
- aria-pressed (attribute)
Keyboard navigation
The Blazor Chart component followed the keyboard interaction guideline, making it easy for people who use assistive technologies (AT) and those who completely rely on keyboard navigation. The following keyboard shortcuts are supported by the Blazor Chart component.
| Windows | Mac | Description |
|---|---|---|
| Alt + J | ⌥ + J | Moves the focus to the chart element. |
| Tab | Tab | Moves the focus to the next element in the chart. |
| Shift + Tab | ⇧ + Tab | Moves the focus to the previous element in the chart. |
| ↓ | ↓ | Moves the focus to the data point right side from the selected point. |
| ↑ | ↑ | Moves the focus to the data point right side from the selected point. |
| ← | ← | Moves the focus to the next series in our Chart component. |
| → | → | Moves the focus to the previous series in our Chart component. |
| Enter / Space | Enter / Space | Selects the data point in the series |
| ↓ , ← | ↓ / ← | Moves the focus to the legend left side from the selected legend. |
| ↑ , → | ↑ / → | Moves the focus to the legend right side from the selected legend. |
| Enter / Space | Enter / Space | Toggles the visibility of the corresponding series. |
| Ctrl + + | ⌘ + + | Zoom in the chart. |
| Ctrl + - | ⌘ + - | Zoom out the chart. |
| ↓ / ↑ | ↓ / ↑ | Pans the chart vertically. |
| ← / → | ← / → | Pans the chart horizontally. |
| R | R | Reset the zoomed chart. |
| Ctrl + P | ⌘ + P | Prints the Chart. |
Ensuring accessibility
The Blazor Chart component’s accessibility levels are ensured through an axe-core with playwright tests.
The accessibility compliance of the Blazor Chart component is shown in the following sample. Open the sample in a new window to evaluate the accessibility of the Blazor Chart component with accessibility tools.