@progress/wct-a11y-spec
Version:
Contains accessibility and keyboard navigation specification of Telerik and Kendo web components.
218 lines • 8.26 kB
JSON
[
{
"h2": "Accessibility Support"
},
{
"p": "Out of the box, the Telerik and Kendo UI TaskBoard provides extensive accessibility support and enables users with disabilities to acquire complete control over its features."
},
{
"p": "The TaskBoard 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 TaskBoard component is a composite component that contains:"
},
{
"ul": [
"`ToolBar` - on top of the component",
"`Columns` - it represents a list of tasks"
]
},
{
"p": "Each Column contains:"
},
{
"ul": [
"`Buttons` - action buttons present on the top of each column",
"`Tasks` - a collection of tasks (cards/list items)"
]
},
{
"table": {
"headers": [
"Selector",
"Attribute",
"Usage"
],
"rows": [
{
"Selector": "`.k-taskboard`",
"Attribute": "`role=application`",
"Usage": "The TaskBoard has `role=application` as its inner navigation requires the use of arrows."
},
{
"Selector": "`.k-taskboard-column`",
"Attribute": "`role=list`",
"Usage": "The TaskBoard Column is a collection of list items."
},
{
"Selector": "",
"Attribute": "`tabindex=0`",
"Usage": "The TaskBoard Column must be focusable."
},
{
"Selector": "",
"Attribute": "`aria-labelledby=.k-taskboard-column-header id`",
"Usage": "The TaskBoard Column must be labelled by its header."
},
{
"Selector": "`.k-taskboard-column-action-button`",
"Attribute": "`role=button` or `nodeName=button`",
"Usage": "The TaskBoard Column actions are buttons."
},
{
"Selector": "",
"Attribute": "`aria-label` or `title`",
"Usage": "Each action must have an accessible name as they are represented by icons and no text is available in their contents."
},
{
"Selector": "`.k-taskboard-card`",
"Attribute": "`role=listitem`",
"Usage": "The TaskBoard Tasks (cards) are list items."
},
{
"Selector": "",
"Attribute": "`tabindex=0`",
"Usage": "The TaskBoard Card must be focusable."
},
{
"Selector": "`.k-taskboard-card-menu-button`",
"Attribute": "`role=button` or `nodeName=button`",
"Usage": "The TaskBoard card menu element must be a button."
},
{
"Selector": "",
"Attribute": "`aria-label` or `title`",
"Usage": "The menu button must have an accessible name as it is represented by an icon and no text is available in its contents."
},
{
"Selector": "`.k-taskboard-pane-header-actions>.k-button`",
"Attribute": "`role=button` or `nodeName=button`",
"Usage": "The TaskBoard edit form close element must be a button."
},
{
"Selector": "",
"Attribute": "`aria-label` or `title`",
"Usage": "The edit form close button must have an accessible name as it is represented by an icon and no text is available in its contents."
},
{
"Selector": "`.k-taskboard-edit-pane .k-form`",
"Attribute": "`role=form`",
"Usage": "The edit Form needs the appropriate role to be assigned to it."
},
{
"Selector": "",
"Attribute": "`aria-labelledby=.k-taskboard-pane-header-text id`",
"Usage": "The TaskBoard edit form must be labeled by the header text of the pane it is located at."
}
]
}
},
{
"h3": "Managing the Focus"
},
{
"p": "The TaskBoard is a composite component. Its content features multiple tab stops. For faster interaction, its elements could also be navigated using the arrow keys."
},
{
"h3": "Keyboard Shortcuts"
},
{
"table": {
"headers": [
"Shortcut",
"Behavior"
],
"rows": [
{
"Shortcut": "`Tab`",
"Behavior": "Navigates the items in the TaskBoard - the ToolBar, each Column, each Button and each Card are dedicated tab stops."
},
{
"Shortcut": "`Left Arrow`",
"Behavior": "Focuses the previous column or a card in the previous column."
},
{
"Shortcut": "`Right Arrow`",
"Behavior": "Focuses the next column or a card in the next column."
},
{
"Shortcut": "`Up Arrow`",
"Behavior": "Focuses the previous card."
},
{
"Shortcut": "`Down Arrow`",
"Behavior": "Focuses the next card."
},
{
"Shortcut": "`Enter`",
"Behavior": "Selects the focused card."
},
{
"Shortcut": "`Delete`",
"Behavior": "Deletes the focused card."
},
{
"Shortcut": "`Ctrl` + `E`",
"Behavior": "Puts the focused card or column in edit mode."
},
{
"Shortcut": "`Ctrl` + `A`",
"Behavior": "Creates a new card or column."
}
]
}
},
{
"h3": "Testing"
},
{
"p": "The TaskBoard 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 TaskBoard 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/#listt",
"title": "WAI-ARIA spec: Role List"
}
}
]
}
]