Accessibility in Blazor Numeric TextBox Component

1 Apr 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 Yes
Section 508 Support Yes
Screen Reader Support Yes
Right-To-Left Support Yes
Color Contrast Yes
Mobile Device Support Yes
Keyboard Navigation Support Yes
Axe-core Accessibility Validation Yes
Yes - All features of the component meet the requirement.
Intermediate - Some features of the component do not meet the requirement.
No - 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>

Accessibility in Blazor NumericTextBox

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.

See also