Accessibility in Blazor Numeric TextBox Component
29 Nov 20244 minutes to read
The Blazor NumericTextBox 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 NumericTextBox 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 NumericTextBox is characterized with complete ARIA Accessibility support that helps to be accessible by on-screen readers and other assistive technology devices. This component designed with the reference of the guidelines document given in WAI ARAI Accessibility practices.
The NumericTextBox uses the spin button role and following ARIA properties to its element based on its state.
| Property | Functionality |
|---|---|
| aria-live | Indicates the priority of updates to a live region |
| aria-valuemin | Specifies the minimum allowable range of the NumericTextBox. |
| aria-valuemax | Specifies the maximum allowable range of the NumericTextBox. |
| aria-disabled | Indicates disabled state of the NumericTextBox. |
| aria-readonly | Indicates the read-only state of the NumericTextBox. |
| aria-valuenow | Specifies the current value of the NumericTextBox. |
| aria-invalid | Indicates that the user input is incorrect or not within acceptable ranges. |
| aria-label | Indicates a string value that labels the NumericTextBox. |
Keyboard interaction
Keyboard interaction of the Blazor NumericTextBox component has been designed based on WAI-ARIA Practices described for the NumericTextBox and it is an alternative to mouse actions to interact with the NumericTextBox.
The following table shows shortcut keys and its corresponding usage.
| Keyboard shortcuts | Actions |
|---|---|
| Arrow Down | Increments the value. |
| Arrow Up | Decrements the value. |
@using Syncfusion.Blazor.Inputs
<SfNumericTextBox TValue="int?" Value=10></SfNumericTextBox>
Ensuring accessibility
The Blazor NumericTextBox component’s accessibility levels are ensured through an axe-core software tool during automated testing.
The accessibility compliance of the NumericTextBox component is shown in the following sample. Open the sample in a new window to evaluate the accessibility of the NumericTextBox component with accessibility tools.