@progress/wct-a11y-spec
Version:
Contains accessibility and keyboard navigation specification of Telerik and Kendo web components.
197 lines • 7.17 kB
JSON
[
{
"h2": "Accessibility Support"
},
{
"p": "Out of the box, the Telerik and Kendo UI DockManager provides extensive accessibility support and enables users with disabilities to acquire complete control over its features."
},
{
"p": "The DockManager 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 DockManager component consists of multiple inner panes, each containing tools, tabs, and content that can be resized, rearranged, and interacted with."
},
{
"table": {
"headers": [
"Selector",
"Attribute",
"Usage"
],
"rows": [
{
"Selector": "`.k-dock-manager`",
"Attribute": "`role=application`",
"Usage": "Indicates that the DockManager has its own keyboard navigation implemented."
},
{
"Selector": "",
"Attribute": "`aria-live=polite`",
"Usage": "Defines dynamic content changes within the DockManager container that need to be announced by screen readers."
},
{
"Selector": "`.k-dock-navigator`",
"Attribute": "`aria-hidden=true`",
"Usage": "The navigator needs to be hidden from the readers as it appears only on drag."
}
]
}
},
{
"h4": "DockManager Toolbar"
},
{
"p": "The Toolbar in the DockManager element of the component should implement the specification for the **Toolbar** component."
},
{
"link": {
"title": "Toolbar accessibility specification",
"source": "{{Toolbar_a11y_link}}"
}
},
{
"h4": "DockManager TabStrip"
},
{
"p": "The TabStrip in the DockManager element of the component should implement the specification for the **TabStrip** component."
},
{
"link": {
"title": "TabStrip accessibility specification",
"source": "{{TabStrip_a11y_link}}"
}
},
{
"h4": "DockManager Splitter"
},
{
"p": "The Splitter in the DockManager element of the component should implement the specification for the **Splitter** component."
},
{
"link": {
"title": "Splitter accessibility specification",
"source": "{{Splitter_a11y_link}}"
}
},
{
"h4": "DockManager Window"
},
{
"p": "The Window elements in the DockManager element of the component should implement the specification for the **Window** component."
},
{
"link": {
"title": "Window accessibility specification",
"source": "{{Window_a11y_link}}"
}
},
{
"h3": "Managing the Focus"
},
{
"p": "The DockManager component provides advanced keyboard navigation to manage the active panes, docking, and focusing of content. These keyboard shortcuts allow users to interact with the DockManager efficiently without requiring a mouse."
},
{
"h3": "Keyboard Shortcuts"
},
{
"h4": "DockManager Navigation"
},
{
"p": "The following keyboard shortcuts can be used to manage the DockManager container and interact with the various panes. These shortcuts provide users with the ability to maximize, minimize, dock, pin, and switch focus across different panes."
},
{
"table": {
"headers": [
"Shortcut",
"Behavior"
],
"rows": [
{
"Shortcut": "`Alt/Option(Mac) + Arrow Up`",
"Behavior": "Maximizes the active pane."
},
{
"Shortcut": "`Alt/Option(Mac) + Arrow Down`",
"Behavior": "Minimizes the active pane."
},
{
"Shortcut": "`Esc`",
"Behavior": "Closes the active pane."
},
{
"Shortcut": "`Alt/Option(Mac) + Arrow Left`",
"Behavior": "Unpins the active pane."
},
{
"Shortcut": "`Alt/Option(Mac) + Arrow Right`",
"Behavior": "Pins the active pane."
},
{
"Shortcut": "`Ctrl/Cmd(Mac) + Arrow Right`",
"Behavior": "Focuses the next content pane."
},
{
"Shortcut": "`Ctrl/Cmd(Mac) + Arrow Left`",
"Behavior": "Focuses the previous content pane."
},
{
"Shortcut": "`Ctrl/Cmd(Mac) + Shift + Arrow Up`",
"Behavior": "Docks the active pane to the global top."
},
{
"Shortcut": "`Ctrl/Cmd(Mac) + Shift + Arrow Down`",
"Behavior": "Docks the active pane to the global bottom."
},
{
"Shortcut": "`Ctrl/Cmd(Mac) + Shift + Arrow Left`",
"Behavior": "Docks the active pane to the global left."
},
{
"Shortcut": "`Ctrl/Cmd(Mac) + Shift + Arrow Right`",
"Behavior": "Docks the active pane to the global right."
}
]
}
},
{
"h3": "Testing"
},
{
"p": "The DockManager 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 DockManager has been tested with the following screen readers and browsers combinations:"
},
{
"table": {
"headers": [
"Environment",
"Tool"
],
"rows": [
[
"Firefox",
"NVDA"
],
[
"Chrome",
"JAWS"
],
[
"Microsoft Edge",
"JAWS"
]
]
}
}
]