[ { "h2": "Accessibility Support" }, { "p": "Out of the box, the Telerik and Kendo UI Carousel provides extensive accessibility support and enables users with disabilities to acquire complete control over its features." }, { "p": "The Carousel 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." }, { "table": { "headers": [ "Selector", "Attribute", "Usage" ], "rows": [ { "Selector": "`.k-scrollview`", "Attribute": "`role=application`", "Usage": "Specifies the role of the Carousel element." }, { "Selector": "", "Attribute": "`aria-roledescription=carousel`", "Usage": "Clarifies the role of the Carousel element." }, { "Selector": "", "Attribute": "`tabindex=0`", "Usage": "Carousel element must be focusable." }, { "Selector": "`.k-scrollview-wrap`", "Attribute": "`role=list`", "Usage": "Clarifies the scrollview wrap as a list of items (images)." }, { "Selector": "`.k-scrollview-nav-wrap>.k-scrollview-nav .k-button`", "Attribute": "`aria-label`", "Usage": "The buttons need an accessible name" }, { "Selector": "`.k-scrollview>.k-sr-only`", "Attribute": "`aria-live=polite`", "Usage": "Identifies a hidden element as a live region in the `polite` state, meaning assistive technology users are informed about changes to the region at the next available opportunity." }, { "Selector": "", "Attribute": "`aria-live=off`", "Usage": "Identifies a hidden element as a live region that is in the `off` state, meaning assistive technology users are not informed about changes to the region." }, { "Selector": "`.k-scrollview-wrap>*`", "Attribute": "`role=listitem`", "Usage": "Specifies the role of each Carousel item." }, { "Selector": "", "Attribute": "`aria-roledescription=slide`", "Usage": "Clarifies the role of the Carousel item." }, { "Selector": "`.k-scrollview-prev,.k-scrollview-next`", "Attribute": "`role=button` or `nodeName=button`", "Usage": "Specifies the role of the element as a Button." }, { "Selector": "", "Attribute": "`aria-label`", "Usage": "Specifies label for the Previous/Next button." }, { "Selector": "", "Attribute": "`aria-controls=.k-scrollview-wrap id`", "Usage": "Points to the id of the items container element." } ] } }, { "p": "The Crousel element and the Carousel navigation buttons (when present) are part of the page tab sequence." }, { "h3": "Keyboard Shortcuts" }, { "h4": "Actions applicable to the Carousel element" }, { "table": { "headers": [ "Shortcut", "Behavior" ], "rows": [ { "Shortcut": "`Left Arrow`", "Behavior": "Switches to the previous item." }, { "Shortcut": "`Right Arrow`", "Behavior": "Switches to the next item." } ] } }, { "h4": "Actions applicable to the navigation buttons" }, { "table": { "headers": [ "Shortcut", "Behavior" ], "rows": [ { "Shortcut": "`Enter`", "Behavior": "Triggers click on the button." }, { "Shortcut": "`Space`", "Behavior": "Triggers click on the button." } ] } }, { "h3": "Testing" }, { "p": "The Carousel 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 Carousel 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/patterns/carousel/", "title": "ARIA Practices: Carousel" } }, { "link": { "source": "https://www.w3.org/WAI/ARIA/apg/example-index/carousel/carousel-1-prev-next.html", "title": "ARIA Practices: Carousel Example with Buttons" } }, { "link": { "source": "https://www.w3.org/WAI/ARIA/apg/patterns/carousel/examples/carousel-1-prev-next/", "title": "ARIA Authoring Practices: Auto-Rotating Image Carousel" } } ] } ]