Skip to content

Commit 58bcbc6

Browse files
github-actions[bot]dimodikendo-bot
authored
Merge a11y-fixes-2669 into production (#2670)
* docs(common): add missing a11y specs * docs: update accessibility and keyboard-nav specs --------- Co-authored-by: Dimo Dimov <[email protected]> Co-authored-by: kendo-bot <[email protected]>
1 parent 7d42167 commit 58bcbc6

File tree

14 files changed

+437
-14
lines changed

14 files changed

+437
-14
lines changed

accessibility/compliance.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ This article lists the accessibility compliance of the Telerik UI for Blazor com
1717

1818
The [Accessibility Conformance Report (ACR)](https://www.section508.gov/sell/acr/) is a document that explains how information and communication technology products such as software, hardware, electronic content, and support documentation conform to leading global accessibility standards. Telerik UI for Blazor provides an ACR through the <a href="https://www.itic.org/policy/accessibility/vpat" target="_blank">Voluntary Product Accessibility Template (VPAT®)</a>.
1919

20-
>tip Download the latest version of the <a href="assets/BlazorVPAT.doc" download>Telerik UI for Blazor Accessibility Conformance Report</a>.
20+
>tip Download the latest version of the <a href="assets/blazorvpat.doc" download>Telerik UI for Blazor Accessibility Conformance Report</a>.
2121
2222
## Compliance Table
2323

@@ -44,7 +44,7 @@ Also check the [notes below the table](#accessibility-compliance-notes).
4444
| Button | AAA | [Standard](https://demos.telerik.com/blazor-ui/button/keyboard-navigation) | [Documentation]({%slug button-wai-aria-support%}) |
4545
| ButtonGroup | AAA | [Standard](https://demos.telerik.com/blazor-ui/buttongroup/keyboard-navigation) | [Documentation]({%slug buttongroup-wai-aria-support%}) |
4646
| Calendar | AAA | [Enhanced](https://demos.telerik.com/blazor-ui/calendar/keyboard-navigation) | [Documentation]({%slug calendar-wai-aria-support%}) |
47-
| Card | N/A | N/A | N/A |
47+
| Card | AA | N/A | [Documentation]({%slug card-wai-aria-support%}) |
4848
| Carousel | AA | [Enhanced](https://demos.telerik.com/blazor-ui/carousel/keyboard-navigation) | [Documentation]({%slug carousel-wai-aria-support%}) |
4949
| Chart | AA | [Enhanced](https://demos.telerik.com/blazor-ui/chart/keyboard-navigation) | [Documentation]({%slug chart-wai-aria-support %}) |
5050
| CheckBox | AA | [Standard](https://demos.telerik.com/blazor-ui/checkbox/overview) | [Documentation]({%slug checkbox-wai-aria-support%}) |
@@ -67,13 +67,13 @@ Also check the [notes below the table](#accessibility-compliance-notes).
6767
| DropDownList | AA | [Enhanced](https://demos.telerik.com/blazor-ui/dropdownlist/keyboard-navigation) | [Documentation]({%slug dropdownlist-wai-aria-support%}) |
6868
| DropZone | N/A | N/A | N/A |
6969
| Editor | AA | [Enhanced](https://demos.telerik.com/blazor-ui/editor/keyboard-navigation) | [Documentation]({%slug editor-wai-aria-support%}) |
70-
| FileManager | AA |[Enhanced](https://demos.telerik.com/blazor-ui/filemanager/overview) | [Documentation]({%slug filemanager-wai-aria-support%}) |
70+
| FileManager | AA |[Enhanced](https://demos.telerik.com/blazor-ui/filemanager/overview) <br /> Also see [Grid](https://demos.telerik.com/blazor-ui/grid/keyboard-navigation), [ListView](https://demos.telerik.com/blazor-ui/listview/keyboard-navigation), [Splitter](https://demos.telerik.com/blazor-ui/splitter/keyboard-navigation), [ToolBar](https://demos.telerik.com/blazor-ui/toolbar/keyboard-navigation), [TreeView](https://demos.telerik.com/blazor-ui/treeview/keyboard-navigation) | [Documentation]({%slug filemanager-wai-aria-support%}) |
7171
| FileSelect | N/A | [Enhanced](https://demos.telerik.com/blazor-ui/fileselect/keyboard-navigation) | TBA |
7272
| Filter | AA | [Enhanced](https://demos.telerik.com/blazor-ui/filter/keyboard-navigation) | [Documentation]({%slug filter-wai-aria-support%}) |
7373
| FlatColorPicker | AA | [Enhanced](https://demos.telerik.com/blazor-ui/flatcolorpicker/overview) | [Documentation]({%slug flatcolorpicker-wai-aria-support%}) |
7474
| FloatingLabel | N/A | N/A | N/A |
7575
| FontIcon | N/A | N/A | N/A |
76-
| Form | AA | [Standard](https://demos.telerik.com/blazor-ui/form/overview) | N/A |
76+
| Form | AA | [Standard](https://demos.telerik.com/blazor-ui/form/overview) | [Documentation]({%slug form-wai-aria-support%}) |
7777
| Gantt | AA | [Enhanced](https://demos.telerik.com/blazor-ui/gantt/keyboard-navigation) | [Documentation]({%slug gantt-wai-aria-support%}) |
7878
| Grid | AA | [Enhanced](https://demos.telerik.com/blazor-ui/grid/keyboard-navigation) | [Documentation]({%slug grid-wai-aria-support%}) |
7979
| GridLayout | N/A | N/A | N/A |
@@ -91,7 +91,7 @@ Also check the [notes below the table](#accessibility-compliance-notes).
9191
| Notification | AA | N/A | [Documentation]({%slug notification-wai-aria-support%}) |
9292
| NumericTextbox | AA | [Enhanced](https://demos.telerik.com/blazor-ui/numerictextbox/keyboard-navigation) | [Documentation]({%slug numerictextbox-wai-aria-support%}) |
9393
| Pager | AA | [Enhanced](https://demos.telerik.com/blazor-ui/pager/keyboard-navigation) | [Documentation]({%slug pager-wai-aria-support%}) |
94-
| PanelBar | AA | [Enhanced](https://demos.telerik.com/blazor-ui/panelbar/keyboard-navigation) | N/A |
94+
| PanelBar | AA | [Enhanced](https://demos.telerik.com/blazor-ui/panelbar/keyboard-navigation) | [Documentation]({%slug panelbar-wai-aria-support%}) |
9595
| PdfViewer | AA | [Enhanced](https://demos.telerik.com/blazor-ui/pdfviewer/overview) | [Documentation]({%slug pdfviewer-wai-aria-support%}) |
9696
| PivotGrid | AA | [Enhanced](https://demos.telerik.com/blazor-ui/pivotgrid/overview) | [Documentation]({%slug pivotgrid-wai-aria-support%}) |
9797
| ProgressBar | AA | N/A | [Documentation]({%slug progressbar-wai-aria-support%}) |
@@ -101,11 +101,11 @@ Also check the [notes below the table](#accessibility-compliance-notes).
101101
| RadialGauge | AA | N/A | N/A |
102102
| RadioGroup | AA | [Standard](https://demos.telerik.com/blazor-ui/radiogroup/keyboard-navigation) | [Documentation]({%slug radiogroup-wai-aria-support%}) |
103103
| RangeSlider | AA | [Enhanced](https://demos.telerik.com/blazor-ui/rangeslider/keyboard-navigation) | [Documentation]({%slug rangeslider-wai-aria-support%}) |
104-
| Rating | AA | N/A | N/A |
104+
| Rating | AA | [Enhanced](https://demos.telerik.com/blazor-ui/rating/keyboard-navigation) | [Documentation]({%slug rating-wai-aria-support%}) |
105105
| Sankey | AA | [Enhanced](https://demos.telerik.com/blazor-ui/sankey/overview) | [Documentation]({%slug sankey-wai-aria-support%}) |
106106
| Scheduler | AA | [Enhanced](https://demos.telerik.com/blazor-ui/scheduler/keyboard-navigation) | [Documentation]({%slug scheduler-wai-aria-support%}) |
107-
| Signature | AA | N/A | [Documentation]({%slug signature-wai-aria-support%}) |
108-
| Skeleton | N/A | N/A | N/A |
107+
| Signature | AA | [Enhanced](https://demos.telerik.com/blazor-ui/signature/overview) | [Documentation]({%slug signature-wai-aria-support%}) |
108+
| Skeleton | AAA | N/A | [Documentation]({%slug skeleton-wai-aria-support%}) |
109109
| Slider | AA | [Enhanced](https://demos.telerik.com/blazor-ui/slider/keyboard-navigation) | [Documentation]({%slug slider-wai-aria-support%}) |
110110
| SplitButton | AA | [Enhanced](https://demos.telerik.com/blazor-ui/splitbutton/keyboard-navigation) | [Documentation]({%slug splitbutton-wai-aria-support%}) |
111111
| Splitter | AA | [Enhanced](https://demos.telerik.com/blazor-ui/splitter/keyboard-navigation) | [Documentation]({%slug splitter-wai-aria-support%}) |
@@ -118,14 +118,14 @@ Also check the [notes below the table](#accessibility-compliance-notes).
118118
| TabStrip | AA | [Enhanced](https://demos.telerik.com/blazor-ui/tabstrip/keyboard-navigation) | [Documentation]({%slug tabstrip-wai-aria-support%}) |
119119
| TextArea | AAA | [Standard](https://demos.telerik.com/blazor-ui/textarea/overview) | [Documentation]({%slug textarea-wai-aria-support%}) |
120120
| TextBox | AA | [Standard](https://demos.telerik.com/blazor-ui/textbox/overview) | [Documentation]({%slug textbox-wai-aria-support%}) |
121-
| TileLayout | AAA | N/A | [Documentation]({%slug tilelayout-wai-aria-support%}) |
121+
| TileLayout | AAA | [Enhanced](https://demos.telerik.com/blazor-ui/tilelayout/overview) | [Documentation]({%slug tilelayout-wai-aria-support%}) |
122122
| TimePicker | AA | [Enhanced](https://demos.telerik.com/blazor-ui/timepicker/keyboard-navigation) | [Documentation]({%slug timepicker-wai-aria-support%}) |
123123
| ToggleButton | AA | [Enhanced](https://demos.telerik.com/blazor-ui/togglebutton/keyboard-navigation) | [Documentation]({%slug togglebutton-wai-aria-support%}) |
124124
| ToolBar | AA | [Enhanced](https://demos.telerik.com/blazor-ui/toolbar/keyboard-navigation) | [Documentation]({%slug toolbar-wai-aria-support%}) |
125-
| Tooltip | AA | N/A | [Documentation]({%slug tooltip-wai-aria-support%}) |
126-
| TreeList | N/A | [Enhanced](https://demos.telerik.com/blazor-ui/treelist/keyboard-navigation) | [Documentation]({%slug treelist-wai-aria-support%}) |
125+
| Tooltip | AA | [Enhanced](https://demos.telerik.com/blazor-ui/tooltip/overview) | [Documentation]({%slug tooltip-wai-aria-support%}) |
126+
| TreeList | AA | [Enhanced](https://demos.telerik.com/blazor-ui/treelist/keyboard-navigation) | [Documentation]({%slug treelist-wai-aria-support%}) |
127127
| TreeView | AA | [Enhanced](https://demos.telerik.com/blazor-ui/treeview/keyboard-navigation) | [Documentation]({%slug treeview-wai-aria-support%}) |
128-
| Upload | N/A | [Enhanced](https://demos.telerik.com/blazor-ui/upload/keyboard-navigation) | [Documentation]({%slug upload-wai-aria-support%}) |
128+
| Upload | AAA | [Enhanced](https://demos.telerik.com/blazor-ui/upload/keyboard-navigation) | [Documentation]({%slug upload-wai-aria-support%}) |
129129
| ValidationMessage | AA | N/A | TBA |
130130
| ValidationTooltip | AA | N/A | TBA |
131131
| ValidationSummary | AA | N/A | TBA |
Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
title: Wai-Aria Support
3+
page_title: Telerik UI for Blazor Card Documentation | Card Accessibility
4+
description: "Get started with the Telerik UI for Blazor Card and learn about its accessibility support for WAI-ARIA, Section 508, and WCAG 2.2."
5+
tags: telerik,blazor,accessibility,wai-aria,wcag
6+
slug: card-wai-aria-support
7+
position: 50
8+
---
9+
10+
# Blazor Card Accessibility
11+
12+
@[template](/_contentTemplates/common/parameters-table-styles.md#table-layout)
13+
14+
15+
16+
Out of the box, the Telerik UI for Blazor Card provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.
17+
18+
19+
The Card is compliant with the [Web Content Accessibility Guidelines (WCAG) 2.2 AA](https://www.w3.org/TR/WCAG22/) standards and [Section 508](https://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 and is tested against the most popular screen readers.
20+
21+
## WAI-ARIA
22+
23+
24+
This section lists the selectors, attributes, and behavior patterns supported by the component and its composite elements, if any.
25+
26+
### Card Component
27+
28+
29+
The Card component is a UI container with styles for organized content. It does not have WAI ARIA and keyboard navigation unless used in a Card List.
30+
31+
| Selector | Attribute | Usage |
32+
| -------- | --------- | ----- |
33+
| `.k-card-list .k-card` | `role=listitem` | When the card is located in a list, it should accept the listitem role. |
34+
| | `tabindex=0` | The card component is focusable. By enabling navigatable setting in the card component, it is focusable and all inner elements are not until Enter key is pressed. |
35+
| | `aria-describedby=.k-card-title id` | Associate the card to the title element when going through the cards. |
36+
| | `aria-keyshortcuts=Enter` | Announces the bound Enter key for the Card component that will enable the navigation inside the card. |
37+
38+
## Section 508
39+
40+
41+
The Card is fully compliant with the [Section 508 requirements](http://www.section508.gov/).
42+
43+
## Testing
44+
45+
46+
The Card has been extensively tested automatically with [axe-core](https://github.com/dequelabs/axe-core) and manually with the most popular screen readers.
47+
48+
> To report any accessibility issues, contact the team through the [Telerik Support System](https://www.telerik.com/account/support-center).
49+
50+
### Screen Readers
51+
52+
53+
The Card has been tested with the following screen readers and browsers combinations:
54+
55+
| Environment | Tool |
56+
| ----------- | ---- |
57+
| Firefox | NVDA |
58+
| Chrome | JAWS |
59+
| Microsoft Edge | JAWS |
60+
61+
62+
63+
## Keyboard Navigation
64+
65+
For details on how the keyboard navigation works in Telerik UI for Blazor, refer to the [Accessibility Overview]({%slug accessibility-overview%}#keyboard-navigation) article.
66+
67+
## See Also
68+
69+
* [Blazor Card Demos](https://demos.telerik.com/blazor-ui/card/overview)
70+
* [Accessibility in Telerik UI for Blazor]({%slug accessibility-overview%})
Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: Wai-Aria Support
3+
page_title: Telerik UI for Blazor Form Documentation | Form Accessibility
4+
description: "Get started with the Telerik UI for Blazor Form and learn about its accessibility support for WAI-ARIA, Section 508, and WCAG 2.2."
5+
tags: telerik,blazor,accessibility,wai-aria,wcag
6+
slug: form-wai-aria-support
7+
position: 50
8+
---
9+
10+
# Blazor Form Accessibility
11+
12+
@[template](/_contentTemplates/common/parameters-table-styles.md#table-layout)
13+
14+
15+
16+
Out of the box, the Telerik UI for Blazor Form provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.
17+
18+
19+
The Form is compliant with the [Web Content Accessibility Guidelines (WCAG) 2.2 AA](https://www.w3.org/TR/WCAG22/) standards and [Section 508](https://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 and is tested against the most popular screen readers.
20+
21+
## WAI-ARIA
22+
23+
24+
This section lists the selectors, attributes, and behavior patterns supported by the component and its composite elements, if any.
25+
26+
### Form Component
27+
28+
29+
The Form component provides a structured way to collect user inputs. It is designed to ensure accessibility and usability for all users, including those with disabilities.
30+
31+
| Selector | Attribute | Usage |
32+
| -------- | --------- | ----- |
33+
| `.k-form` | `role=form` or `nodeName=form` | Omitted if the `<form>` DOM element is used. |
34+
35+
### Input elements
36+
37+
38+
The Form field input element of the component should indicate if it is required and announce any hints or error messages.
39+
40+
## Section 508
41+
42+
43+
The Form is fully compliant with the [Section 508 requirements](http://www.section508.gov/).
44+
45+
## Testing
46+
47+
48+
The Form has been extensively tested automatically with [axe-core](https://github.com/dequelabs/axe-core) and manually with the most popular screen readers.
49+
50+
> To report any accessibility issues, contact the team through the [Telerik Support System](https://www.telerik.com/account/support-center).
51+
52+
### Screen Readers
53+
54+
55+
The Form has been tested with the following screen readers and browsers combinations:
56+
57+
| Environment | Tool |
58+
| ----------- | ---- |
59+
| Firefox | NVDA |
60+
| Chrome | JAWS |
61+
| Microsoft Edge | JAWS |
62+
63+
64+
65+
## Keyboard Navigation
66+
67+
For details on how the keyboard navigation works in Telerik UI for Blazor, refer to the [Accessibility Overview]({%slug accessibility-overview%}#keyboard-navigation) article.
68+
69+
## See Also
70+
71+
* [Blazor Form Demos](https://demos.telerik.com/blazor-ui/form/overview)
72+
* [Accessibility in Telerik UI for Blazor]({%slug accessibility-overview%})
Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
title: Wai-Aria Support
3+
page_title: Telerik UI for Blazor PanelBar Documentation | PanelBar Accessibility
4+
description: "Get started with the Telerik UI for Blazor PanelBar and learn about its accessibility support for WAI-ARIA, Section 508, and WCAG 2.2."
5+
tags: telerik,blazor,accessibility,wai-aria,wcag
6+
slug: panelbar-wai-aria-support
7+
position: 50
8+
---
9+
10+
# Blazor PanelBar Accessibility
11+
12+
@[template](/_contentTemplates/common/parameters-table-styles.md#table-layout)
13+
14+
15+
16+
Out of the box, the Telerik UI for Blazor PanelBar provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.
17+
18+
19+
The PanelBar is compliant with the [Web Content Accessibility Guidelines (WCAG) 2.2 AA](https://www.w3.org/TR/WCAG22/) standards and [Section 508](https://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 and is tested against the most popular screen readers.
20+
21+
## WAI-ARIA
22+
23+
24+
This section lists the selectors, attributes, and behavior patterns supported by the component and its composite elements, if any.
25+
26+
| Selector | Attribute | Usage |
27+
| -------- | --------- | ----- |
28+
| `.k-panelbar` | `role=tree` | The root element of the PanelBar has role `tree`. |
29+
| | `aria-activedescendant=.k-item id` | Points to the currently focused item in the PanelBar. |
30+
| `.k-panelbar-group` | `role=group` | The `ul` element that wraps child nodes. |
31+
| `[aria-expanded='false']>.k-panelbar-group` | `aria-hidden=true` | Hides the `group` element from assistive technologies when its parent is not expanded. |
32+
| `.k-item` | `role=treeitem` | The `li` element rendered for a PanelBar item. |
33+
| | `aria-expanded=true/false` | Announces the expanded state of the item (if expandable). It is `true` when expanded, and `false` when collapsed. |
34+
| | `aria-selected=true/false` | Announces the selected state of the item. |
35+
36+
## Resources
37+
38+
[ARIA practices Navigation Treeview Example](https://www.w3.org/WAI/ARIA/apg/example-index/treeview/treeview-navigation.html)
39+
40+
## Section 508
41+
42+
43+
The PanelBar is fully compliant with the [Section 508 requirements](http://www.section508.gov/).
44+
45+
## Testing
46+
47+
48+
The PanelBar has been extensively tested automatically with [axe-core](https://github.com/dequelabs/axe-core) and manually with the most popular screen readers.
49+
50+
> To report any accessibility issues, contact the team through the [Telerik Support System](https://www.telerik.com/account/support-center).
51+
52+
### Screen Readers
53+
54+
55+
The PanelBar has been tested with the following screen readers and browsers combinations:
56+
57+
| Environment | Tool |
58+
| ----------- | ---- |
59+
| Firefox | NVDA |
60+
| Chrome | JAWS |
61+
| Microsoft Edge | JAWS |
62+
63+
64+
65+
## Keyboard Navigation
66+
67+
For details on how the PanelBar keyboard navigation works, refer to the [Blazor PanelBar Accessibility and Keyboard Navigation Demo](https://demos.telerik.com/blazor-ui/panelbar/keyboard-navigation).
68+
69+
## See Also
70+
71+
* [Accessibility in Telerik UI for Blazor]({%slug accessibility-overview%})

0 commit comments

Comments
 (0)