@progress/wct-a11y-spec

[ { "h2": "Accessibility Support" }, { "p": "Out of the box, the Telerik and Kendo UI Upload provides extensive accessibility support and enables users with disabilities to acquire complete control over its features." }, { "p": "The Upload 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 Upload selected files list implements roving tabindex navigation. Meaning that only one file has tabindex=0." }, { "table": { "headers": [ "Selector", "Attribute", "Usage" ], "rows": [ { "Selector": "`.k-upload .k-upload-button`", "Attribute": "`aria-disabled=true/false`", "Usage": "Announces the disabled state of the upload button." }, { "Selector": "", "Attribute": "`aria-expanded=true/false`", "Usage": "Indicates whether the controlled list of files is present/visible" }, { "Selector": "", "Attribute": "`aria-controls=.k-upload-files id`", "Usage": "Creates the relationship between the button and the list of selected files when the list is present. Remove the attribute when list is not present." }, { "Selector": "`.k-upload input`", "Attribute": "`tabindex=-1`", "Usage": "Assures that the input element inside the upload is not focusable." }, { "Selector": "", "Attribute": "`aria-hidden=true`", "Usage": "The input needs to be hidden from the readers." }, { "Selector": "`.k-upload-files`", "Attribute": "`role=list`", "Usage": "Explicitly sets the UL role to list because of https://developer.mozilla.org/en-US/docs/Web/CSS/list-style#accessibility_concerns" }, { "Selector": "", "Attribute": "`id`", "Usage": "Unique and deterministic id linked to the button aria-controls attribute." }, { "Selector": "`.k-upload-files .k-file`", "Attribute": "`role=listitem`", "Usage": "Explicitly sets the LI role to listitem because of https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/listitem_role#best_practices (note 2)." }, { "Selector": "", "Attribute": "`tabindex=0/-1`", "Usage": "The element should be focusable. Value should be changed dynamically based on the roving tabindex navigation." }, { "Selector": "`.k-upload .k-file .k-file-validation-message`", "Attribute": "`aria-live=polite`", "Usage": "Announces the change in the upload status of the file." }, { "Selector": "`.k-upload .k-upload-actions .k-upload-action`", "Attribute": "`aria-hidden=true`", "Usage": "The list file action buttons must be hidden from the readers." }, { "Selector": "", "Attribute": "`tabindex=-1`", "Usage": "Assures that the list file action buttons are not focusable elements." } ] } }, { "h3": "Managing the Focus" }, { "p": "The Upload component contains a single or multiple tab stops depending on its configuration and content. When the `autoUpload` option is set to true, the `Select Files` button is the first tabstop and starting point for the navigation. When there are selected files present, the file list is a separate tab stop, implementing roving tab index (only one item is focusable and it is changed dynamically based on navigation). Setting the `autoUpload` to false, the `Clear` and `Upload` buttons are included in the tab sequence." }, { "ul": [ "When a selected file is deleted, the focus is moved to the next file (if present), the previous one (if there is no next, and there is previous), or to the `Select Files` button if there are no files left in the list." ] }, { "h3": "Keyboard Shortcuts" }, { "table": { "headers": [ "Shortcut", "Behavior" ], "rows": [ { "Shortcut": "`Tab`", "Behavior": "Switches focus between the Select File Button, the list of selected files, and the action buttons (Cancel, Upload) after the file list." }, { "Shortcut": "`Space/Enter`", "Behavior": "Opens the Select file dialog if the Select files button is focused." }, { "Shortcut": "`DownArrow`", "Behavior": "Highlights the next file in the file list (if such exists) when a file list item is focused." }, { "Shortcut": "`UpArrow`", "Behavior": "Highlights the previous file in the file list (if such exists) when a file list item is focused." }, { "Shortcut": "`Enter`", "Behavior": "Retries the upload of the failed file when the focus is on a file list item or starts the file upload for a valid file." }, { "Shortcut": "`Escape`", "Behavior": "Cancels the upload of the highlighted file when the focus is on a file list item" }, { "Shortcut": "`Space`", "Behavior": "When Chunk upload is enabled Start or Pause the highlighted file upload" }, { "Shortcut": "`Delete`", "Behavior": "Removes the highlighted file when the focus is on a file list item. Focus is moved to the next file (if present), previous file (if there is no next and there is previous), or is returned to the Select Files button if the last file from the list is deleted." } ] } }, { "h3": "Testing" }, { "p": "The Upload 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 Upload 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/WAI/ARIA/apg/", "title": "WAI-ARIA Practices" } } ] } ]