Skip to content

Commit f986048

Browse files
committed
docs: update accessibility and keyboard-nav specs
1 parent 652f9e3 commit f986048

File tree

1 file changed

+95
-0
lines changed

1 file changed

+95
-0
lines changed
Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
---
2+
title: Wai-Aria Support
3+
page_title: Telerik UI for Blazor DockManager Documentation | DockManager Accessibility
4+
description: "Get started with the Telerik UI for Blazor DockManager 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: dockmanager-wai-aria-support
7+
position: 50
8+
---
9+
10+
# Blazor DockManager 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 DockManager provides extensive accessibility support and enables users with disabilities to acquire complete control over its features.
17+
18+
19+
The DockManager 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+
27+
The DockManager component consists of multiple inner panes, each containing tools, tabs, and content that can be resized, rearranged, and interacted with.
28+
29+
| Selector | Attribute | Usage |
30+
| -------- | --------- | ----- |
31+
| `.k-dock-manager` | `role=application` | Indicates that the DockManager has its own keyboard navigation implemented. |
32+
| | `aria-live=polite` | Defines dynamic content changes within the DockManager container that need to be announced by screen readers. |
33+
| `.k-dock-navigator` | `aria-hidden=true` | The navigator needs to be hidden from the readers as it appears only on drag. |
34+
35+
### DockManager Toolbar
36+
37+
38+
The Toolbar in the DockManager element of the component should implement the specification for the **Toolbar** component.
39+
40+
[Toolbar accessibility specification]({{Toolbar_a11y_link}})
41+
42+
### DockManager TabStrip
43+
44+
45+
The TabStrip in the DockManager element of the component should implement the specification for the **TabStrip** component.
46+
47+
[TabStrip accessibility specification]({{TabStrip_a11y_link}})
48+
49+
### DockManager Splitter
50+
51+
52+
The Splitter in the DockManager element of the component should implement the specification for the **Splitter** component.
53+
54+
[Splitter accessibility specification]({{Splitter_a11y_link}})
55+
56+
### DockManager Window
57+
58+
59+
The Window elements in the DockManager element of the component should implement the specification for the **Window** component.
60+
61+
[Window accessibility specification]({{Window_a11y_link}})
62+
63+
## Section 508
64+
65+
66+
The DockManager is fully compliant with the [Section 508 requirements](http://www.section508.gov/).
67+
68+
## Testing
69+
70+
71+
The DockManager has been extensively tested automatically with [axe-core](https://github.com/dequelabs/axe-core) and manually with the most popular screen readers.
72+
73+
> To report any accessibility issues, contact the team through the [Telerik Support System](https://www.telerik.com/account/support-center).
74+
75+
### Screen Readers
76+
77+
78+
The DockManager has been tested with the following screen readers and browsers combinations:
79+
80+
| Environment | Tool |
81+
| ----------- | ---- |
82+
| Firefox | NVDA |
83+
| Chrome | JAWS |
84+
| Microsoft Edge | JAWS |
85+
86+
87+
88+
## Keyboard Navigation
89+
90+
For details on how the keyboard navigation works in Telerik UI for Blazor, refer to the [Accessibility Overview](slug://accessibility-overview#keyboard-navigation) article.
91+
92+
## See Also
93+
94+
* [Blazor Dock Manager Demos](https://demos.telerik.com/blazor-ui/dockmanager/overview)
95+
* [Accessibility in Telerik UI for Blazor](slug://accessibility-overview)

0 commit comments

Comments
 (0)