Accessibility in Blazor Numeric TextBox Component
24 Aug 20232 minutes to read
The 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 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>