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 for its component role, provides options for managing its focus and is tested against the most popular screen readers.

WAI-ARIA

This section lists the selectors, attributes, and behavior patterns supported by the component and its composite elements, if any.

SelectorAttributeUsage
.k-input-innerrole=spinbuttonAnnounces the spin button capabilities of the NumericTextBox.
label for or aria-label or aria-labelledbyThe input requires an accessible name that will be assigned to it.
aria-valuemnowAnnounces the value for the component.
aria-valueminAnnounces the minimum value allowed for the component.
aria-valuemaxAnnounces the maximum value allowed for the component.
aria-invalid=trueThe attribute is rendered only when the NumericTextBox is in a form and announces the valid state of the component.
.k-disabled .k-input-innerdisabled=disabled or aria-disabled=trueThe attribute is rendered only when the NumericTextBox is disabled.
.k-spin-button>.k-buttonrole=button or nodeName=buttonAnnounces the spin button capabilities of the NumericTextBox.
aria-labelThe button element must have discernible text.

Managing the Focus

The NumericTextBox provides a standard focusable input.

Keyboard Shortcuts

The MaskedTextBox supports the default input cursor navigation with the Left Arrow and Right Arrow keys.

ShortcutBehavior
Up ArrowIncreases the value of the focused NumericTextBox with the step.
Down ArrowDecreases the value of the focused NumericTextBox with the step.

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