@progress/wct-a11y-spec
Version:
Contains accessibility and keyboard navigation specification of Telerik and Kendo web components.
174 lines • 7.27 kB
JSON
[
{
"h2": "Accessibility Support"
},
{
"p": "Out of the box, the Telerik and Kendo UI Sankey provides extensive accessibility support and enables users with disabilities to acquire complete control over its features."
},
{
"p": "The Sankey 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 Sankey Chart is an interactive Graphics Document (https://www.w3.org/TR/graphics-aria-1.0/#graphics-document). All actions available for mouse users are also available via keyboard shortcuts."
},
{
"table": {
"headers": [
"Selector",
"Attribute",
"Usage"
],
"rows": [
{
"Selector": "`.k-sankey`",
"Attribute": "`role=graphics-document`",
"Usage": "Indicates that the Sankey element is a Graphics Document."
},
{
"Selector": "",
"Attribute": "`aria-roledescription`",
"Usage": "User-set value that clarifies the type of Chart to screen reader users."
},
{
"Selector": "",
"Attribute": "`aria-label`",
"Usage": "Announces the user-set title of the Sankey Chart."
},
{
"Selector": "`.k-sankey-node`",
"Attribute": "`role=graphics-symbol`",
"Usage": "Specifies the role of the Sankey node elements."
},
{
"Selector": "",
"Attribute": "`aria-roledescription=Node`",
"Usage": "Describes the role of the Sankey node elements."
},
{
"Selector": "`.k-sankey-legend-item`",
"Attribute": "`role=checkbox`",
"Usage": "Specifies the role of the legend item element."
},
{
"Selector": "",
"Attribute": "`aria-label`",
"Usage": "Specifies the name of the node associated with this legend item."
},
{
"Selector": "",
"Attribute": "`aria-roledescription=Legend item`",
"Usage": "Specifies the name of the node associated with this legend item."
}
]
}
},
{
"h3": "Managing the Focus"
},
{
"p": "The Sankey comes with keyboard navigation enabled out of the box. The main interactive parts of the Sankey diagram are reachable through the keyboard - the nodes and links."
},
{
"h3": "Keyboard Navigation"
},
{
"p": "Once the Sankey element receives focus via the keyboard, the focus highlight will be displayed on the first node. Navigation through nodes and links is controlled using the arrow keys. Pressing `Tab` moves the focus out of the Sankey to the next focusable element on the page. Clicking on a node or link moves the focus to the clicked element without drawing a focus highlight."
},
{
"table": {
"headers": [
"Shortcut",
"Behavior"
],
"rows": [
{
"Shortcut": "`Tab`",
"Behavior": "Moves the focus to the next focusable element on the page."
},
{
"Shortcut": "`Shift + Tab`",
"Behavior": "Moves the focus to the previous focusable element on the page."
},
{
"Shortcut": "`Up` arrow key",
"Behavior": "If the focus is on a node, moves to the node above (if it exists). If the focus is on a link, moves to the link above (if it exists) within the same source or target links collection as the focused link."
},
{
"Shortcut": "`Down` arrow key",
"Behavior": "If the focus is on a node, moves to the node below (if it exists). If the focus is on a link, moves to the link below (if it exists) within the same source or target links collection as the focused link."
},
{
"Shortcut": "`Left` arrow key",
"Behavior": "If the focus is on a node, moves to its first link on the left side (if it exists). If the focus is on a link, moves to the node on the left side of the focused link."
},
{
"Shortcut": "`Right` arrow key",
"Behavior": "If the focus is on a node, moves to its first link on the right side (if it exists). If the focus is on a link, moves to the node on the right side of the focused link."
},
{
"Shortcut": "`Escape` key",
"Behavior": "Moves the focus to the topmost first node of the Sankey."
}
]
}
},
{
"h3": "Testing"
},
{
"p": "The Sankey 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 Sankey 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/graphics-aria-1.0/",
"title": "WAI-ARIA Graphics Module"
}
},
{
"link": {
"source": "https://a11y-style-guide.com/style-guide/section-media.html#kssref-media-svgs",
"title": "Accessibility Style Guide: SVGs"
}
}
]
}
]