Accessibility in Blazor SplitButton Component
4 Nov 20254 minutes to read
The Blazor SplitButton component follows 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 SplitButton component is outlined below.
| Accessibility Criteria | Compatibility |
|---|---|
| WCAG 2.2 Support |  |
| Section 508 Support | |
| Screen Reader Support | |
| Right-To-Left Support | Not Applicable |
| 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 SplitButton component applies WAI-ARIA patterns to meet accessibility requirements. The following ARIA attributes are used in the Blazor SplitButton component:
| Attributes | Purpose |
|---|---|
role |
Identifies the SplitButton as a button, the SplitButton popup as a menu, and popup action items as menuitem. |
aria-haspopup |
Indicates that the button opens an interactive SplitButton popup (menu). |
aria-expanded |
Reflects whether the SplitButton popup is currently expanded or collapsed. |
aria-owns |
Associates elements to define a parent/child relationship when it cannot be represented in the DOM hierarchy. |
aria-disabled |
Indicates that the element is perceivable but disabled and not operable. |
Keyboard interaction
The Blazor SplitButton component follows keyboard interaction guidelines, making it usable for people who rely on assistive technologies (AT) and keyboard navigation. The following keyboard shortcuts are supported:
| Windows | Mac | Actions |
|---|---|---|
| Esc | Esc | Closes the opened popup. |
| Enter | Enter | Opens the popup, or activates the highlighted item and closes the popup. |
| Space | Space | Opens the popup. |
| ↑ | ↑ | Navigates up to the previous action item. |
| ↓ | ↓ | Navigates down to the next action item. |
| Alt + ↑ | ⌥ + ↑ | Closes the popup. |
| Alt + ↓ | ⌥ + ↓ | Opens the popup. |
Ensuring accessibility
The Blazor SplitButton component’s accessibility is validated using axe-core with Playwright tests.
The accessibility compliance of the Blazor SplitButton component is shown in the following sample. Open the sample in a new window to evaluate the accessibility of the Blazor SplitButton component with accessibility tools.