Accessibility in Blazor Scheduler Component
20 Sep 20247 minutes to read
The Blazor Scheduler 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 Scheduler component is outlined below.
Accessibility Criteria | Compatibility |
---|---|
WCAG 2.2 Support | |
Section 508 Support | |
Screen Reader Support | |
Right-To-Left Support | |
Color Contrast | |
Mobile Device Support | |
Keyboard Navigation Support | |
Axe-core Accessibility Validation |
WAI-ARIA attributes
WAI-ARIA (Accessibility Initiative – Accessible Rich Internet Applications) defines a way to increase the accessibility of web pages, dynamic content, and user interface components developed with Ajax, HTML, JavaScript, and related technologies. ARIA provides additional semantics to describe the role, state, and functionality of web components.
The following ARIA attributes are used in the Scheduler:
Attributes | Purpose |
---|---|
role=”main” | Attribute added to the Scheduler element describes the actual role of the element and denote it as a main and unique content. |
role=”button” | Attribute is assigned to the appointments of Scheduler, to denote it as a clickable element. |
aria-label | Attribute is set to the Scheduler parent element and its default value is Scheduler’s current date. On every time, the date is navigated, this attribute is updated with appropriate current date values. It is also assigned to other scheduler UI elements such as previous and next date navigation buttons depicting its purpose, div element displaying date range in the header bar and appointment elements. |
aria-labelledby | It indicates editor dialog title to the user through assistive technologies. |
aria-describedby | It indicates editor dialog content description to the user through assistive technologies. |
aria-disabled | Attribute is set to the appointment element to indicates the disabled state of the Scheduler. |
Keyboard interaction
All the Scheduler actions can be controlled via keyboard keys and is availed by using AllowKeyboardInteraction
property which is set to true
by default. The applicable key combinations and its relative functionalities are listed below.
Keyboard shortcuts | Actions |
---|---|
Alt + J | Focuses the Scheduler [Provided from application end]. |
Tab | Focuses the first or active item on the scheduler header bar and then moves the focus to the next available event elements. If no events present, then focus moves out of the component. |
Shift + Tab | Reverse focusing of the Tab functionality. Inverse focusing of event elements from the last one and then moves onto the first or active item on Scheduler header bar and then moves out of the component. |
Ctrl + Shift + Arrow (keys) | Focuses the event element and then moves the focus to the next available event elements between the resources. |
Escape | Closes any of the popup that are in open state. |
Arrow | To move onto the next available cells in either of the needed directions (left, right, top and right) |
Shift + Arrow | For multiple cell selection on either direction. |
Delete | Deletes one or more selected events. |
Ctrl + Click on events | To select multiple events. |
Alt + Number (from 1 to 6) | To switch between the views on Scheduler. |
Ctrl + Left Arrow | To navigate to the previous date period. |
Ctrl + Right Arrow | To navigate to the next date period. |
Left or Right Arrow | On pressing any of these keys when focus is currently on the Scheduler header bar, moves the focus to the previous or next items in the header bar. |
Space or Enter | It activates any of the focused items. |
Page Up & Page Down | To scroll through the work cells area. |
Home | To move the selection to the first cell of Scheduler. |
F12 | To have the inline option for both cells and events. |
Shift + Alt + Y | To navigate to today date. |
Shift + Alt + N | To open editor window. |
Ensuring accessibility
The Blazor Scheduler component’s accessibility levels are ensured through an axe-core software tool during automated testing.
The accessibility compliance of the Scheduler component is shown in the following sample. Open the sample in a new window to evaluate the accessibility of the Scheduler component with accessibility tools.