@progress/wct-a11y-spec

[ { "h2": "Accessibility Support" }, { "p": "Out of the box, the Telerik and Kendo UI Scheduler provides extensive accessibility support and enables users with disabilities to acquire complete control over its features." }, { "p": "The Scheduler is compliant with the [Web Content Accessibility Guidelines (WCAG) 2.2 standards](https://www.w3.org/TR/WCAG22/) and [Section 508](http://www.section508.gov/) requirements, follows the [Web Accessibility Initiative - Accessible Rich Internet Applications (WAI-ARIA)](https://www.w3.org/WAI/ARIA/apg/) best practices for implementing the [keyboard navigation](#keyboard-navigation) for its `component` role, provides options for [managing its focus](#managing-the-focus) and is tested against the most popular [screen readers](#screen-readers)." }, { "h3": "WAI-ARIA" }, { "p": "This section lists the selectors, attributes, and behavior patterns supported by the component and its composite elements, if any." }, { "p": "The component is a single tab stop, so the arrows must be used for internal navigation. Notable exception is that scrollable containers in non-agenda views should be focusable too." }, { "h4": "Scheduler Wrapping Element" }, { "table": { "headers": [ "Selector", "Attribute", "Usage" ], "rows": [ { "Selector": "`.k-scheduler`", "Attribute": "`role=application`", "Usage": "Specifies the role of the component." }, { "Selector": "", "Attribute": "`aria-activedescendant=.k-event.k-selected id`", "Usage": "Points to the currently active appointment in the Scheduler." } ] } }, { "h4": "Scheduler Toolbar" }, { "p": "The Scheduler toolbar must implement the specification for a ToolBar component." }, { "link": { "title": "ToolBar accessibility specification", "source": "{{toolbar_a11y_link}}" } }, { "p": "Below are listed the requirements for those components part of the ToolBar." }, { "table": { "headers": [ "Selector", "Attribute", "Usage" ], "rows": [ { "Selector": "`.k-nav-prev,.k-nav-next`", "Attribute": "`aria-label`", "Usage": "Required as those buttons contain only icon (no text)." }, { "Selector": "`.k-nav-current`", "Attribute": "`aria-live=polite`", "Usage": "The new date of the Scheduler view will be announced upon navigation to new time span / view type." }, { "Selector": "`.k-views-dropdown`", "Attribute": "`aria-label`", "Usage": "Specifies the purpose of the element. The `<select>` element visible on the toolbar on small screens must have its `aria-label` set." } ] } }, { "p": "Depending on the current view, The Scheduler component implements different roles. Below are described the three possible approaches:" }, { "h4": "Scheduler in Agenda view" }, { "p": "In case of an Agenda view, the role assigned to the Scheduler layout table (`k-scheduler-layout` element) must be `grid`." }, { "h5": "Table element" }, { "table": { "headers": [ "Selector", "Attribute", "Usage" ], "rows": [ { "Selector": "`.k-scheduler-agendaview`", "Attribute": "`role=grid`", "Usage": "The main table of the Agenda view must indicate it is a Data Grid." }, { "Selector": "`.k-scheduler-agendaview>tbody`", "Attribute": "`role=none/presentation`", "Usage": "The `<tbody>` element must have its semantics removed." }, { "Selector": "`.k-scheduler-agendaview .k-scheduler-table`", "Attribute": "`role=none/presentation`", "Usage": "Those `<table>` elements within the Scheduler must have their semantic role removed." }, { "Selector": "`.k-scheduler-agendaview .k-scheduler-table>tbody`", "Attribute": "`role=rowgroup`", "Usage": "Those elements must have their role explicitly set as it has been removed by the `<table>` role set (none/presentation)." }, { "Selector": "`.k-scheduler-agendaview .k-scheduler-table>tbody>tr`", "Attribute": "`role=row`", "Usage": "Those elements must have their role explicitly set as it has been removed by the `<table>` role set (none/presentation)." }, { "Selector": "`.k-scheduler-agendaview .k-scheduler-table>tbody>tr>th`", "Attribute": "`role=columnheader`", "Usage": "Those elements must have their role explicitly set as it has been removed by the `<table>` role set (none/presentation)." }, { "Selector": "`.k-scheduler-agendaview .k-scheduler-content tr .k-selected`", "Attribute": "`aria-selected`", "Usage": "`aria-selected` attribute must be used to signify the currently selected row. As in Agenda view the selection follows focus, that would be the current `active descendant` row." } ] } }, { "h5": "Content table td.k-scheduler-groupcolumn and td.k-scheduler-datecolumn elements" }, { "table": { "headers": [ "Selector", "Attribute", "Usage" ], "rows": [ { "Selector": "`.k-scheduler-content>.k-scheduler-table>tbody>tr>.k-scheduler-groupcolumn,.k-scheduler-content>.k-scheduler-table>tbody>tr>.k-scheduler-datecolumn`", "Attribute": "`role=rowheader`", "Usage": "Those elements must have their role explicitly set as it has been removed by the `<table>` role set (none/presentation)." }, { "Selector": "`.k-scheduler-content>.k-scheduler-table>tbody>tr>.k-scheduler-timecolumn,.k-scheduler-content>.k-scheduler-table>tbody>tr>.k-scheduler-timecolumn+td`", "Attribute": "`role=gridcell`", "Usage": "Those elements must have their role explicitly set as it has been removed by the `<table>` role set (none/presentation)." } ] } }, { "h4": "Scheduler in Year view" }, { "p": "Scheduler in Year view implements the ARIA specification of the **MultiViewCalendar**." }, { "h4": "Scheduler in all other views" }, { "p": "For the rest of the views the `role=\"none/presentation\"` must be used on all inner `<table>` elements in the widget. This way we could freely implement managed focused inside the component based on the arrow keys." }, { "table": { "headers": [ "Selector", "Attribute", "Usage" ], "rows": [ { "Selector": "`.k-scheduler-dayview,.k-scheduler-monthview,.k-scheduler-timelineview`", "Attribute": "`role=none/presentation`", "Usage": "All `<table>` elements within the Scheduler must have their semantic role removed." }, { "Selector": "`.k-event`", "Attribute": "`role=button`", "Usage": "Indicating that the events element is interactive." }, { "Selector": "", "Attribute": "`aria-label`", "Usage": "Label containing the title, start, and end date of the appointment, so that all of them are announced upon navigation to an appointment." }, { "Selector": "`.k-scheduler-layout:not(.k-scheduler-agendaview) .k-scheduler-content`", "Attribute": "`tabindex=0`", "Usage": "Scrollable elements need to be focusable (does not apply to agenda view) to ensure scrolling with the arrow keys is available." } ] } }, { "h3": "Managing the Focus" }, { "p": "The component is a single tab stop, so the arrows must be used for internal navigation." }, { "p": "The navigation will be always on, and won't need a `Navigable` parameter like the Grid. Focusing the Component will have the following effect, depending on whether appointments are loaded, or the component is empty:" }, { "ul": [ "empty scheduler - the focus is on the scheduler component itself.", "non-empty - the first appointment is focused." ] }, { "p": "Roving tab index is used to track the currently focused appointment." }, { "p": "After CRUD operation, if the manipulated appointment remains in the current view, the focus should return to that appointment. If it has been deleted, or it has been edited, so that it moves outside of the current view, the focus should reset to the first appointment in the view (if any), or to the Scheduler itself." }, { "h3": "Keyboard Shortcuts" }, { "h4": "Scheduler Content" }, { "h4": "Actions applied to the content" }, { "table": { "headers": [ "Shortcut", "Behavior" ], "rows": [ { "Shortcut": "`t`", "Behavior": "navigates to today's time period" }, { "Shortcut": "`c`", "Behavior": "opens the popup for creation of new appointment" }, { "Shortcut": "`b`", "Behavior": "toggles view between business hours and full day (where available)" }, { "Shortcut": "`Shift+ Left Arrow`", "Behavior": "navigates to the previous time period" }, { "Shortcut": "`Shift+ Right Arrow`", "Behavior": "navigates to the next time period" }, { "Shortcut": "`Alt/Opt(Mac) + 1,2,3,...`", "Behavior": "navigates to the view with the respective number" }, { "Shortcut": "`F10`", "Behavior": "Focuses the ToolBar." } ] } }, { "h4": "Actions applied to focusable appointments" }, { "p": "All of the content keyboard shortcuts work when focus is on the appointment. In addition to that we also have:" }, { "table": { "headers": [ "Shortcut", "Behavior" ], "rows": [ { "Shortcut": "`Arrow Keys`", "Behavior": "move focus through appointments and the `more events` button, then continue to the next appointment in sequence" }, { "Shortcut": "`Enter`", "Behavior": "opens the Edit Popup to modify the appointment" }, { "Shortcut": "`Delete/Backspace`", "Behavior": "opens the Delete confirmation popup to modify the appointment" } ] } }, { "h4": "Actions when Scheduler is in Year view" }, { "p": "Scheduler content in Year view implements keyboard navigation spec for the **MultiViewCalendar**. In addition it also has the following shortcuts:" }, { "table": { "headers": [ "Shortcut", "Behavior" ], "rows": [ { "Shortcut": "`Enter`", "Behavior": "If date is focused, opens its Tooltip." }, { "Shortcut": "`Enter`", "Behavior": "If Tooltip is focused, navigates to Day view displaying the Tooltip date." }, { "Shortcut": "`Delete/Backspace`", "Behavior": "If a Tooltip is focused, closes that and returns focus to its target date." } ] } }, { "h4": "Scheduler Toolbar" }, { "table": { "headers": [ "Shortcut", "Behavior" ], "rows": [ { "Shortcut": "`Left/Right ArrowKeys`", "Behavior": "move focus through tools" }, { "Shortcut": "`Down ArrowKeys`", "Behavior": "moves focus to the selected (if present), or the first event (if any) in the view" } ] } }, { "h4": "Scheduler Popups" }, { "p": "Using the default Window component shortcuts" }, { "h3": "Testing" }, { "p": "The Scheduler has been extensively tested automatically with [axe-core](https://github.com/dequelabs/axe-core) and manually with the most popular screen readers." }, { "h3": "Screen Readers" }, { "p": "The Scheduler has been tested with the following screen readers and browsers combinations:" }, { "table": { "headers": [ "Environment", "Tool" ], "rows": [ [ "Firefox", "NVDA" ], [ "Chrome", "JAWS" ], [ "Microsoft Edge", "JAWS" ] ] } }, { "h3": "Resources" }, { "ul": [ { "link": { "source": "https://www.w3.org/TR/wai-aria-1.2/#grid", "title": "WAI-ARIA specification for grid" } }, { "link": { "source": "https://www.w3.org/TR/wai-aria-1.2/#application", "title": "WAI-ARIA specification for application" } } ] } ]