Skip to main content

NumericTextBox

NumericTextBoxes allow users to provide numeric values in a specific and predefined format.

Accessibility Support

Out of the box, the Telerik and Kendo UI Numerictextbox provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.

The Numerictextbox is compliant with the Web Content Accessibility Guidelines (WCAG) 2.2 standards and Section 508 requirements, follows the Web Accessibility Initiative - Accessible Rich Internet Applications (WAI-ARIA) best practices for implementing the keyboard navigation and provides options for managing its focus and is tested against the most popular screen readers.

NumericTextbox

ARIA Attributes

AttributeDescription
role="spinbutton"Announces the spin button capabilities of the NumericTextBox.
aria-label|aria-labelledbyThe input requires an accessible name (provided by consuming app).
aria-valuenowAnnounces the current value of the component.
aria-valueminAnnounces the minimum allowed value.
aria-valuemaxAnnounces the maximum allowed value.
aria-invalid="true"Rendered when the NumericTextBox is in an invalid state.
aria-describedbyPoints to the hint or error message.
aria-disabled="true"Rendered when the NumericTextBox is disabled.
role="button"Describes the role of the spin buttons.
aria-labelThe button element requires discernible text.

Keyboard Navigation

TriggerBehavior
ArrowUpIncreases the value of the focused NumericTextBox with the step.
ArrowDownDecreases the value of the focused NumericTextBox with the step.

UX Behavior

FeatureDescription
Spin buttonsUp and down arrow buttons increment and decrement the value.
Min / MaxEnforces a configurable minimum and maximum value.
StepThe increment step size is configurable.
FormatThe value is displayed using the configured number format.
Disabled stateWhen disabled, the input and spin buttons are non-interactive.

Testing

The Numerictextbox has been extensively tested automatically with axe-core and manually with the most popular screen readers.

Screen Readers

The Numerictextbox has been tested with the following screen readers and browsers combinations:

EnvironmentTool
FirefoxNVDA
ChromeJAWS
Microsoft EdgeJAWS

Resources

Feedback