You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: accessibility/compliance.md
+12-12Lines changed: 12 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -17,7 +17,7 @@ This article lists the accessibility compliance of the Telerik UI for Blazor com
17
17
18
18
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 <ahref="https://www.itic.org/policy/accessibility/vpat"target="_blank">Voluntary Product Accessibility Template (VPAT®)</a>.
19
19
20
-
>tip Download the latest version of the <ahref="assets/BlazorVPAT.doc"download>Telerik UI for Blazor Accessibility Conformance Report</a>.
20
+
>tip Download the latest version of the <ahref="assets/blazorvpat.doc"download>Telerik UI for Blazor Accessibility Conformance Report</a>.
21
21
22
22
## Compliance Table
23
23
@@ -44,7 +44,7 @@ Also check the [notes below the table](#accessibility-compliance-notes).
| Carousel | AA |[Enhanced](https://demos.telerik.com/blazor-ui/carousel/keyboard-navigation)|[Documentation]({%slug carousel-wai-aria-support%}) |
49
49
| Chart | AA |[Enhanced](https://demos.telerik.com/blazor-ui/chart/keyboard-navigation)|[Documentation]({%slug chart-wai-aria-support %}) |
50
50
| 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).
67
67
| DropDownList | AA |[Enhanced](https://demos.telerik.com/blazor-ui/dropdownlist/keyboard-navigation)|[Documentation]({%slug dropdownlist-wai-aria-support%}) |
68
68
| DropZone | N/A | N/A | N/A |
69
69
| 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%}) |
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.
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%})
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. |
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