Accessibility in Angular Numerictextbox component
27 Apr 20245 minutes to read
The 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 Numerictextbox component is outlined below.
WAI-ARIA attributes
The NumericTextBox characterized with complete ARIA Accessibility support which helps to 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 spinbutton
role and following ARIA properties to its element based on its state.
Property | Functionality |
---|---|
aria-live | The aria-live attribute indicates the priority of updates to a live region |
aria-valuemin | The aria-valuemin property specifies the minimum allowable range of the NumericTextBox. |
aria-valuemax | The aria-valuemax property specifies the maximum allowable range of the NumericTextBox. |
aria-disabled | The aria-disabled property indicates disabled state of the NumericTextBox. |
aria-readonly | The aria-readonly property indicates the read-only state of the NumericTextBox. |
aria-valuenow | The aria-valuenow property specifies the current value of the NumericTextBox. |
aria-invalid | The aria-invalid property indicates that the user input is incorrect or not within acceptable ranges. |
aria-label | The aria-label property 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 below table shows shortcut keys and its corresponding usage.
Keyboard shortcuts | Actions |
---|---|
Arrow Down | Increments the value. |
Arrow Up | Decrements the value |
import { NgModule } from '@angular/core'
import { BrowserModule } from '@angular/platform-browser'
import { NumericTextBoxModule } from '@syncfusion/ej2-angular-inputs'
import { FormsModule } from '@angular/forms'
import { Component } from '@angular/core';
@Component({
imports: [
NumericTextBoxModule,
FormsModule
],
standalone: true,
selector: 'app-root',
// specifies the template string for the NumericTextBox component
// sets value to the NumericTextBox
template: `
<ejs-numerictextbox value='10'></ejs-numerictextbox>
`
})
export class AppComponent {
constructor() {
}
}
import { bootstrapApplication } from '@angular/platform-browser';
import { AppComponent } from './app.component';
import 'zone.js';
bootstrapApplication(AppComponent).catch((err) => console.error(err));
Ensuring accessibility
The NumericTextBox component’s accessibility levels are ensured through an accessibility-checker and axe-core software tools 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.